diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index 54c250bd0fc..0110183f3bf 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -4732,7 +4732,7 @@ } } }, - "revision": "20240821", + "revision": "20240912", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -5253,7 +5253,7 @@ "type": "string" }, "billingPeriodDuration": { - "description": "Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center.", + "description": "Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created.", "type": "string" }, "gracePeriodDuration": { @@ -7085,11 +7085,11 @@ "type": "string" }, "billingPeriodDuration": { - "description": "Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center.", + "description": "Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created.", "type": "string" }, "committedPaymentsCount": { - "description": "Required. The number of payments the user is committed to.", + "description": "Required. Immutable. The number of payments the user is committed to. It is immutable after the base plan is created.", "format": "int32", "type": "integer" }, @@ -7112,7 +7112,7 @@ "type": "string" }, "renewalType": { - "description": "Required. Installments base plan renewal type. Determines the behavior at the end of the initial commitment.", + "description": "Required. Immutable. Installments base plan renewal type. Determines the behavior at the end of the initial commitment. The renewal type is immutable after the base plan is created.", "enum": [ "RENEWAL_TYPE_UNSPECIFIED", "RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT", @@ -7748,7 +7748,7 @@ "id": "PrepaidBasePlanType", "properties": { "billingPeriodDuration": { - "description": "Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center.", + "description": "Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created.", "type": "string" }, "timeExtension": { diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 7cc7e0cc1b2..9def30dfca4 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -1245,8 +1245,9 @@ type AutoRenewingBasePlanType struct { // range P0D (zero days) to P30D (30 days). If not specified, the default value // is P30D (30 days). AccountHoldDuration string `json:"accountHoldDuration,omitempty"` - // BillingPeriodDuration: Required. Subscription period, specified in ISO 8601 - // format. For a list of acceptable billing periods, refer to the help center. + // BillingPeriodDuration: Required. Immutable. Subscription period, specified + // in ISO 8601 format. For a list of acceptable billing periods, refer to the + // help center. The duration is immutable after the base plan is created. BillingPeriodDuration string `json:"billingPeriodDuration,omitempty"` // GracePeriodDuration: Grace period of the subscription, specified in ISO 8601 // format. Acceptable values are P0D (zero days), P3D (3 days), P7D (7 days), @@ -3652,11 +3653,12 @@ type InstallmentsBasePlanType struct { // P0D (zero days) to P30D (30days). If not specified, the default value is // P30D (30 days). AccountHoldDuration string `json:"accountHoldDuration,omitempty"` - // BillingPeriodDuration: Required. Subscription period, specified in ISO 8601 - // format. For a list of acceptable billing periods, refer to the help center. + // BillingPeriodDuration: Required. Immutable. Subscription period, specified + // in ISO 8601 format. For a list of acceptable billing periods, refer to the + // help center. The duration is immutable after the base plan is created. BillingPeriodDuration string `json:"billingPeriodDuration,omitempty"` - // CommittedPaymentsCount: Required. The number of payments the user is - // committed to. + // CommittedPaymentsCount: Required. Immutable. The number of payments the user + // is committed to. It is immutable after the base plan is created. CommittedPaymentsCount int64 `json:"committedPaymentsCount,omitempty"` // GracePeriodDuration: Grace period of the subscription, specified in ISO 8601 // format. Acceptable values are P0D (zero days), P3D (3 days), P7D (7 days), @@ -3676,8 +3678,9 @@ type InstallmentsBasePlanType struct { // period of their existing subscription will be used to extend the duration of // the new billing plan. ProrationMode string `json:"prorationMode,omitempty"` - // RenewalType: Required. Installments base plan renewal type. Determines the - // behavior at the end of the initial commitment. + // RenewalType: Required. Immutable. Installments base plan renewal type. + // Determines the behavior at the end of the initial commitment. The renewal + // type is immutable after the base plan is created. // // Possible values: // "RENEWAL_TYPE_UNSPECIFIED" - Unspecified state. @@ -4598,8 +4601,9 @@ type PendingCancellation struct { // PrepaidBasePlanType: Represents a base plan that does not automatically // renew at the end of the base plan, and must be manually renewed by the user. type PrepaidBasePlanType struct { - // BillingPeriodDuration: Required. Subscription period, specified in ISO 8601 - // format. For a list of acceptable billing periods, refer to the help center. + // BillingPeriodDuration: Required. Immutable. Subscription period, specified + // in ISO 8601 format. For a list of acceptable billing periods, refer to the + // help center. The duration is immutable after the base plan is created. BillingPeriodDuration string `json:"billingPeriodDuration,omitempty"` // TimeExtension: Whether users should be able to extend this prepaid base plan // in Google Play surfaces. Defaults to TIME_EXTENSION_ACTIVE if not specified. diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index e9e70c49ec6..37efa8dcdbf 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -39,6 +39,11 @@ "endpointUrl": "https://bigquery.europe-west3.rep.googleapis.com/", "location": "europe-west3" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://bigquery.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, { "description": "Regional Endpoint", "endpointUrl": "https://bigquery.europe-west9.rep.googleapis.com/", @@ -1935,7 +1940,7 @@ } } }, - "revision": "20240815", + "revision": "20240905", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3269,12 +3274,12 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example \"123456789012/environment\" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example \"Production\". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.", + "description": "Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example \"123456789012/environment\" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example \"Production\". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.", "type": "object" }, "restrictions": { "$ref": "RestrictionConfig", - "description": "Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.", + "description": "Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.", "readOnly": true }, "satisfiesPzi": { @@ -4516,7 +4521,7 @@ "type": "object" }, "HparamTuningTrial": { - "description": "Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.", + "description": "Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.", "id": "HparamTuningTrial", "properties": { "endTimeMs": { @@ -4614,6 +4619,7 @@ "NOT_SUPPORTED_IN_STANDARD_EDITION", "INDEX_SUPPRESSED_BY_FUNCTION_OPTION", "QUERY_CACHE_HIT", + "STALE_INDEX", "INTERNAL_ERROR", "OTHER_REASON" ], @@ -4636,6 +4642,7 @@ "Indicates that search indexes can not be used for search query with STANDARD edition.", "Indicates that an option in the search function that cannot make use of the index has been selected.", "Indicates that the query was cached, and thus the search index was not used.", + "The index cannot be used in the search query because it is stale.", "Indicates an internal error that causes the search index to be unused.", "Indicates that the reason search indexes cannot be used in the query is not covered by any of the other IndexUnusedReason options." ], @@ -4810,7 +4817,7 @@ }, "jobCreationReason": { "$ref": "JobCreationReason", - "description": "Output only. The reason why a Job was created. [Preview](/products/#product-launch-stages)", + "description": "Output only. The reason why a Job was created. [Preview](https://cloud.google.com/products/#product-launch-stages)", "readOnly": true }, "jobReference": { @@ -5370,7 +5377,7 @@ "type": "object" }, "JobCreationReason": { - "description": "Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages)", + "description": "Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages)", "id": "JobCreationReason", "properties": { "code": { @@ -5854,7 +5861,7 @@ "readOnly": true }, "statementType": { - "description": "Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.", + "description": "Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.", "readOnly": true, "type": "string" }, @@ -6370,7 +6377,7 @@ "id": "MlStatistics", "properties": { "hparamTrials": { - "description": "Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.", + "description": "Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.", "items": { "$ref": "HparamTuningTrial" }, @@ -6378,7 +6385,7 @@ "type": "array" }, "iterationResults": { - "description": "Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).", + "description": "Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).", "items": { "$ref": "IterationResult" }, @@ -6459,7 +6466,7 @@ "enumDescriptions": [ "Unspecified training type.", "Single training with fixed parameter space.", - "[Hyperparameter tuning training](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview)." + "[Hyperparameter tuning training](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview)." ], "readOnly": true, "type": "string" @@ -6483,7 +6490,7 @@ "type": "string" }, "defaultTrialId": { - "description": "Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.", + "description": "Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.", "format": "int64", "readOnly": true, "type": "string" @@ -6524,7 +6531,7 @@ "readOnly": true }, "hparamTrials": { - "description": "Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.", + "description": "Output only. Trials of a [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.", "items": { "$ref": "HparamTuningTrial" }, @@ -6621,7 +6628,7 @@ "type": "string" }, "optimalTrialIds": { - "description": "Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.", + "description": "Output only. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.", "items": { "format": "int64", "type": "string" @@ -6688,7 +6695,7 @@ "id": "ModelExtractOptions", "properties": { "trialId": { - "description": "The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.", + "description": "The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.", "format": "int64", "type": "string" } @@ -7109,7 +7116,7 @@ "description": "Optional. Output format adjustments." }, "jobCreationMode": { - "description": "Optional. If not set, jobs are always required. If set, the query request will follow the behavior described JobCreationMode. [Preview](/products/#product-launch-stages)", + "description": "Optional. If not set, jobs are always required. If set, the query request will follow the behavior described JobCreationMode. [Preview](https://cloud.google.com/products/#product-launch-stages)", "enum": [ "JOB_CREATION_MODE_UNSPECIFIED", "JOB_CREATION_REQUIRED", @@ -7216,7 +7223,7 @@ }, "jobCreationReason": { "$ref": "JobCreationReason", - "description": "Optional. The reason why a Job was created. Only relevant when a job_reference is present in the response. If job_reference is not present it will always be unset. [Preview](/products/#product-launch-stages)" + "description": "Optional. The reason why a Job was created. Only relevant when a job_reference is present in the response. If job_reference is not present it will always be unset. [Preview](https://cloud.google.com/products/#product-launch-stages)" }, "jobReference": { "$ref": "JobReference", @@ -7238,7 +7245,7 @@ "type": "string" }, "queryId": { - "description": "Auto-generated ID for the query. [Preview](/products/#product-launch-stages)", + "description": "Auto-generated ID for the query. [Preview](https://cloud.google.com/products/#product-launch-stages)", "type": "string" }, "rows": { @@ -7502,7 +7509,7 @@ ], "enumDescriptions": [ "Should never be used.", - "Restrict data egress. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details." + "Restrict data egress. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details." ], "readOnly": true, "type": "string" @@ -8266,7 +8273,7 @@ "type": "string" }, "locationUri": { - "description": "Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.", + "description": "Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.", "type": "string" }, "outputFormat": { @@ -8565,7 +8572,7 @@ }, "restrictions": { "$ref": "RestrictionConfig", - "description": "Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.", + "description": "Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.", "readOnly": true }, "schema": { @@ -8604,7 +8611,7 @@ "description": "If specified, configures time-based partitioning for this table." }, "type": { - "description": "Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.", + "description": "Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.", "readOnly": true, "type": "string" }, @@ -9035,7 +9042,7 @@ "description": "Metadata caching eligible table referenced in the query." }, "tableType": { - "description": "[Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).", + "description": "[Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).", "type": "string" }, "unusedReason": { diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 82d41a7a90f..d4bd7e23e40 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -2078,18 +2078,21 @@ type Dataset struct { // value can be from 48 to 168 hours (2 to 7 days). The default value is 168 // hours if this is not set. MaxTimeTravelHours int64 `json:"maxTimeTravelHours,omitempty,string"` - // ResourceTags: Optional. The tags (/bigquery/docs/tags) attached to this - // dataset. Tag keys are globally unique. Tag key is expected to be in the - // namespaced format, for example "123456789012/environment" where 123456789012 - // is the ID of the parent organization or project resource for this tag key. - // Tag value is expected to be the short name, for example "Production". See - // Tag definitions (/iam/docs/tags-access-control#definitions) for more + // ResourceTags: Optional. The tags + // (https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag + // keys are globally unique. Tag key is expected to be in the namespaced + // format, for example "123456789012/environment" where 123456789012 is the ID + // of the parent organization or project resource for this tag key. Tag value + // is expected to be the short name, for example "Production". See Tag + // definitions + // (https://cloud.google.com/iam/docs/tags-access-control#definitions) for more // details. ResourceTags map[string]string `json:"resourceTags,omitempty"` // Restrictions: Optional. Output only. Restriction config for all tables and // dataset. If set, restrict certain accesses on the dataset and all its tables // based on the config. See Data egress - // (/bigquery/docs/analytics-hub-introduction#data_egress) for more details. + // (https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) + // for more details. Restrictions *RestrictionConfig `json:"restrictions,omitempty"` // SatisfiesPzi: Output only. Reserved for future use. SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` @@ -3829,8 +3832,8 @@ func (s HparamSearchSpaces) MarshalJSON() ([]byte, error) { } // HparamTuningTrial: Training info of a trial in hyperparameter tuning -// (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie -// w) models. +// (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) +// models. type HparamTuningTrial struct { // EndTimeMs: Ending time of the trial. EndTimeMs int64 `json:"endTimeMs,omitempty,string"` @@ -3949,6 +3952,8 @@ type IndexUnusedReason struct { // search function that cannot make use of the index has been selected. // "QUERY_CACHE_HIT" - Indicates that the query was cached, and thus the // search index was not used. + // "STALE_INDEX" - The index cannot be used in the search query because it is + // stale. // "INTERNAL_ERROR" - Indicates an internal error that causes the search // index to be unused. // "OTHER_REASON" - Indicates that the reason search indexes cannot be used @@ -4190,7 +4195,7 @@ type Job struct { // Id: Output only. Opaque ID field of the job. Id string `json:"id,omitempty"` // JobCreationReason: Output only. The reason why a Job was created. Preview - // (/products/#product-launch-stages) + // (https://cloud.google.com/products/#product-launch-stages) JobCreationReason *JobCreationReason `json:"jobCreationReason,omitempty"` // JobReference: Optional. Reference describing the unique-per-user name of the // job. @@ -4894,7 +4899,7 @@ func (s JobConfigurationTableCopy) MarshalJSON() ([]byte, error) { // when used with `JOB_CREATION_OPTIONAL` Job creation mode. For `jobs.insert` // (https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) // method calls it will always be `REQUESTED`. Preview -// (/products/#product-launch-stages) +// (https://cloud.google.com/products/#product-launch-stages) type JobCreationReason struct { // Code: Output only. Specifies the high level reason why a Job was created. // @@ -5267,93 +5272,90 @@ type JobStatistics2 struct { SparkStatistics *SparkStatistics `json:"sparkStatistics,omitempty"` // StatementType: Output only. The type of query statement, if valid. Possible // values: * `SELECT`: `SELECT` - // (/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. - // * `ASSERT`: `ASSERT` - // (/bigquery/docs/reference/standard-sql/debugging-statements#assert) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) + // statement. * `ASSERT`: `ASSERT` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) // statement. * `INSERT`: `INSERT` - // (/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) // statement. * `UPDATE`: `UPDATE` - // (/bigquery/docs/reference/standard-sql/query-syntax#update_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) // statement. * `DELETE`: `DELETE` - // (/bigquery/docs/reference/standard-sql/data-manipulation-language) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) // statement. * `MERGE`: `MERGE` - // (/bigquery/docs/reference/standard-sql/data-manipulation-language) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) // statement. * `CREATE_TABLE`: `CREATE TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_table_ - // statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: - // `CREATE TABLE AS SELECT` - // (/bigquery/docs/reference/standard-sql/data-definition-language#query_stateme - // nt) statement. * `CREATE_VIEW`: `CREATE VIEW` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_view_s - // tatement) statement. * `CREATE_MODEL`: `CREATE MODEL` - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_mod - // el_statement) statement. * `CREATE_MATERIALIZED_VIEW`: `CREATE MATERIALIZED - // VIEW` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_materi - // alized_view_statement) statement. * `CREATE_FUNCTION`: `CREATE FUNCTION` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_functi - // on_statement) statement. * `CREATE_TABLE_FUNCTION`: `CREATE TABLE FUNCTION` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_table_ - // function_statement) statement. * `CREATE_PROCEDURE`: `CREATE PROCEDURE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_proced - // ure) statement. * `CREATE_ROW_ACCESS_POLICY`: `CREATE ROW ACCESS POLICY` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_row_ac - // cess_policy_statement) statement. * `CREATE_SCHEMA`: `CREATE SCHEMA` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_schema - // _statement) statement. * `CREATE_SNAPSHOT_TABLE`: `CREATE SNAPSHOT TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_snapsh - // ot_table_statement) statement. * `CREATE_SEARCH_INDEX`: `CREATE SEARCH - // INDEX` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_search - // _index_statement) statement. * `DROP_TABLE`: `DROP TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_st - // atement) statement. * `DROP_EXTERNAL_TABLE`: `DROP EXTERNAL TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_external - // _table_statement) statement. * `DROP_VIEW`: `DROP VIEW` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_sta - // tement) statement. * `DROP_MODEL`: `DROP MODEL` - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) + // statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: `CREATE TABLE AS + // SELECT` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) + // statement. * `CREATE_VIEW`: `CREATE VIEW` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) + // statement. * `CREATE_MODEL`: `CREATE MODEL` + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) + // statement. * `CREATE_MATERIALIZED_VIEW`: `CREATE MATERIALIZED VIEW` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) + // statement. * `CREATE_FUNCTION`: `CREATE FUNCTION` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) + // statement. * `CREATE_TABLE_FUNCTION`: `CREATE TABLE FUNCTION` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) + // statement. * `CREATE_PROCEDURE`: `CREATE PROCEDURE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) + // statement. * `CREATE_ROW_ACCESS_POLICY`: `CREATE ROW ACCESS POLICY` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) + // statement. * `CREATE_SCHEMA`: `CREATE SCHEMA` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) + // statement. * `CREATE_SNAPSHOT_TABLE`: `CREATE SNAPSHOT TABLE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) + // statement. * `CREATE_SEARCH_INDEX`: `CREATE SEARCH INDEX` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) + // statement. * `DROP_TABLE`: `DROP TABLE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) + // statement. * `DROP_EXTERNAL_TABLE`: `DROP EXTERNAL TABLE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) + // statement. * `DROP_VIEW`: `DROP VIEW` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) + // statement. * `DROP_MODEL`: `DROP MODEL` + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) // statement. * `DROP_MATERIALIZED_VIEW`: `DROP MATERIALIZED VIEW` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_material - // ized_view_statement) statement. * `DROP_FUNCTION` : `DROP FUNCTION` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_function - // _statement) statement. * `DROP_TABLE_FUNCTION` : `DROP TABLE FUNCTION` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_fu - // nction) statement. * `DROP_PROCEDURE`: `DROP PROCEDURE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedur - // e_statement) statement. * `DROP_SEARCH_INDEX`: `DROP SEARCH INDEX` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_i - // ndex) statement. * `DROP_SCHEMA`: `DROP SCHEMA` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_s - // tatement) statement. * `DROP_SNAPSHOT_TABLE`: `DROP SNAPSHOT TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot - // _table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP ALL] ROW - // ACCESS POLICY|POLICIES` - // (/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_acce - // ss_policy_statement) statement. * `ALTER_TABLE`: `ALTER TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_s - // et_options_statement) statement. * `ALTER_VIEW`: `ALTER VIEW` - // (/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_se - // t_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: `ALTER - // MATERIALIZED VIEW` - // (/bigquery/docs/reference/standard-sql/data-definition-language#alter_materia - // lized_view_set_options_statement) statement. * `ALTER_SCHEMA`: `ALTER - // SCHEMA` - // (/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema - // _set_options_statement) statement. * `SCRIPT`: `SCRIPT` - // (/bigquery/docs/reference/standard-sql/procedural-language). * - // `TRUNCATE_TABLE`: `TRUNCATE TABLE` - // (/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) + // statement. * `DROP_FUNCTION` : `DROP FUNCTION` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) + // statement. * `DROP_TABLE_FUNCTION` : `DROP TABLE FUNCTION` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) + // statement. * `DROP_PROCEDURE`: `DROP PROCEDURE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) + // statement. * `DROP_SEARCH_INDEX`: `DROP SEARCH INDEX` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) + // statement. * `DROP_SCHEMA`: `DROP SCHEMA` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) + // statement. * `DROP_SNAPSHOT_TABLE`: `DROP SNAPSHOT TABLE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) + // statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP ALL] ROW ACCESS + // POLICY|POLICIES` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) + // statement. * `ALTER_TABLE`: `ALTER TABLE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) + // statement. * `ALTER_VIEW`: `ALTER VIEW` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) + // statement. * `ALTER_MATERIALIZED_VIEW`: `ALTER MATERIALIZED VIEW` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) + // statement. * `ALTER_SCHEMA`: `ALTER SCHEMA` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) + // statement. * `SCRIPT`: `SCRIPT` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). + // * `TRUNCATE_TABLE`: `TRUNCATE TABLE` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) // statement. * `CREATE_EXTERNAL_TABLE`: `CREATE EXTERNAL TABLE` - // (/bigquery/docs/reference/standard-sql/data-definition-language#create_extern - // al_table_statement) statement. * `EXPORT_DATA`: `EXPORT DATA` - // (/bigquery/docs/reference/standard-sql/other-statements#export_data_statement - // ) statement. * `EXPORT_MODEL`: `EXPORT MODEL` - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) + // statement. * `EXPORT_DATA`: `EXPORT DATA` + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) + // statement. * `EXPORT_MODEL`: `EXPORT MODEL` + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) // statement. * `LOAD_DATA`: `LOAD DATA` - // (/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) // statement. * `CALL`: `CALL` - // (/bigquery/docs/reference/standard-sql/procedural-language#call) statement. + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) + // statement. StatementType string `json:"statementType,omitempty"` // Timeline: Output only. Describes a timeline of job execution. Timeline []*QueryTimelineSample `json:"timeline,omitempty"` @@ -6009,13 +6011,12 @@ func (s MetadataCacheStatistics) MarshalJSON() ([]byte, error) { // MlStatistics: Job statistics specific to a BigQuery ML training job. type MlStatistics struct { // HparamTrials: Output only. Trials of a hyperparameter tuning job - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w) sorted by trial_id. + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) + // sorted by trial_id. HparamTrials []*HparamTuningTrial `json:"hparamTrials,omitempty"` // IterationResults: Results for all completed iterations. Empty for // hyperparameter tuning jobs - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w). + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview). IterationResults []*IterationResult `json:"iterationResults,omitempty"` // MaxIterations: Output only. Maximum number of iterations specified as // max_iterations in the 'CREATE MODEL' query. The actual number of iterations @@ -6057,8 +6058,8 @@ type MlStatistics struct { // "TRAINING_TYPE_UNSPECIFIED" - Unspecified training type. // "SINGLE_TRAINING" - Single training with fixed parameter space. // "HPARAM_TUNING" - [Hyperparameter tuning - // training](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tunin - // g-overview). + // training](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bi + // gqueryml-syntax-hp-tuning-overview). TrainingType string `json:"trainingType,omitempty"` // ForceSendFields is a list of field names (e.g. "HparamTrials") to // unconditionally include in API requests. By default, fields with empty or @@ -6086,11 +6087,10 @@ type Model struct { CreationTime int64 `json:"creationTime,omitempty,string"` // DefaultTrialId: Output only. The default trial_id to use in TVFs when the // trial_id is not passed in. For single-objective hyperparameter tuning - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w) models, this is the best trial ID. For multi-objective hyperparameter - // tuning - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w) models, this is the smallest trial ID among all Pareto optimal trials. + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) + // models, this is the best trial ID. For multi-objective hyperparameter tuning + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) + // models, this is the smallest trial ID among all Pareto optimal trials. DefaultTrialId int64 `json:"defaultTrialId,omitempty,string"` // Description: Optional. A user-friendly description of this model. Description string `json:"description,omitempty"` @@ -6117,8 +6117,8 @@ type Model struct { // model. HparamSearchSpaces *HparamSearchSpaces `json:"hparamSearchSpaces,omitempty"` // HparamTrials: Output only. Trials of a hyperparameter tuning - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w) model sorted by trial_id. + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) + // model sorted by trial_id. HparamTrials []*HparamTuningTrial `json:"hparamTrials,omitempty"` // LabelColumns: Output only. Label columns that were used to train this model. // The output of the model will have a "predicted_" prefix to these columns. @@ -6169,11 +6169,11 @@ type Model struct { // clause along with statistics useful for ML analytic functions. ModelType string `json:"modelType,omitempty"` // OptimalTrialIds: Output only. For single-objective hyperparameter tuning - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w) models, it only contains the best trial. For multi-objective - // hyperparameter tuning - // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overvie - // w) models, it contains all Pareto optimal trials sorted by trial_id. + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) + // models, it only contains the best trial. For multi-objective hyperparameter + // tuning + // (https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) + // models, it contains all Pareto optimal trials sorted by trial_id. OptimalTrialIds googleapi.Int64s `json:"optimalTrialIds,omitempty"` // RemoteModelInfo: Output only. Remote model info RemoteModelInfo *RemoteModelInfo `json:"remoteModelInfo,omitempty"` @@ -6256,9 +6256,9 @@ func (s ModelDefinitionModelOptions) MarshalJSON() ([]byte, error) { type ModelExtractOptions struct { // TrialId: The 1-based ID of the trial to be exported from a hyperparameter // tuning model. If not specified, the trial with id = Model - // (/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is - // exported. This field is ignored for models not trained with hyperparameter - // tuning. + // (https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId + // is exported. This field is ignored for models not trained with + // hyperparameter tuning. TrialId int64 `json:"trialId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "TrialId") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -6900,7 +6900,7 @@ type QueryRequest struct { FormatOptions *DataFormatOptions `json:"formatOptions,omitempty"` // JobCreationMode: Optional. If not set, jobs are always required. If set, the // query request will follow the behavior described JobCreationMode. Preview - // (/products/#product-launch-stages) + // (https://cloud.google.com/products/#product-launch-stages) // // Possible values: // "JOB_CREATION_MODE_UNSPECIFIED" - If unspecified JOB_CREATION_REQUIRED is @@ -7029,7 +7029,8 @@ type QueryResponse struct { JobComplete bool `json:"jobComplete,omitempty"` // JobCreationReason: Optional. The reason why a Job was created. Only relevant // when a job_reference is present in the response. If job_reference is not - // present it will always be unset. Preview (/products/#product-launch-stages) + // present it will always be unset. Preview + // (https://cloud.google.com/products/#product-launch-stages) JobCreationReason *JobCreationReason `json:"jobCreationReason,omitempty"` // JobReference: Reference to the Job that was created to run the query. This // field will be present even if the original request timed out, in which case @@ -7052,7 +7053,7 @@ type QueryResponse struct { // (https://cloud.google.com/bigquery/docs/paging-results). PageToken string `json:"pageToken,omitempty"` // QueryId: Auto-generated ID for the query. Preview - // (/products/#product-launch-stages) + // (https://cloud.google.com/products/#product-launch-stages) QueryId string `json:"queryId,omitempty"` // Rows: An object with as many results as can be contained within the maximum // permitted reply size. To get any additional rows, you can call @@ -7419,8 +7420,8 @@ type RestrictionConfig struct { // Possible values: // "RESTRICTION_TYPE_UNSPECIFIED" - Should never be used. // "RESTRICTED_DATA_EGRESS" - Restrict data egress. See [Data - // egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more - // details. + // egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#dat + // a_egress) for more details. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Type") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -8346,8 +8347,8 @@ type StorageDescriptor struct { // maximum length is 128 characters. InputFormat string `json:"inputFormat,omitempty"` // LocationUri: Optional. The physical location of the table (e.g. - // 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or - // 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes. + // `gs://spark-dataproc-data/pangea-data/case_sensitive/` or + // `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes. LocationUri string `json:"locationUri,omitempty"` // OutputFormat: Optional. Specifies the fully qualified class name of the // OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The @@ -8610,7 +8611,8 @@ type Table struct { ResourceTags map[string]string `json:"resourceTags,omitempty"` // Restrictions: Optional. Output only. Restriction config for table. If set, // restrict certain accesses on the table based on the config. See Data egress - // (/bigquery/docs/analytics-hub-introduction#data_egress) for more details. + // (https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) + // for more details. Restrictions *RestrictionConfig `json:"restrictions,omitempty"` // Schema: Optional. Describes the schema of this table. Schema *TableSchema `json:"schema,omitempty"` @@ -8640,8 +8642,8 @@ type Table struct { // `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * // `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a // base table at a particular time. See additional information on table - // snapshots (/bigquery/docs/table-snapshots-intro). The default value is - // `TABLE`. + // snapshots (https://cloud.google.com/bigquery/docs/table-snapshots-intro). + // The default value is `TABLE`. Type string `json:"type,omitempty"` // View: Optional. The view definition. View *ViewDefinition `json:"view,omitempty"` @@ -9266,7 +9268,7 @@ type TableMetadataCacheUsage struct { // TableReference: Metadata caching eligible table referenced in the query. TableReference *TableReference `json:"tableReference,omitempty"` // TableType: Table type - // (/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type). + // (https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type). TableType string `json:"tableType,omitempty"` // UnusedReason: Reason for not using metadata caching for the table. // diff --git a/classroom/v1/classroom-api.json b/classroom/v1/classroom-api.json index 11cdbe40fb8..319e2e8829f 100644 --- a/classroom/v1/classroom-api.json +++ b/classroom/v1/classroom-api.json @@ -575,14 +575,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -751,14 +751,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -795,14 +795,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -836,14 +836,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -870,7 +870,7 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" @@ -888,7 +888,7 @@ }, "postId": { "deprecated": true, - "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.", + "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -1072,14 +1072,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -1250,14 +1250,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -1294,14 +1294,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -1335,14 +1335,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -1369,7 +1369,7 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" @@ -1387,7 +1387,7 @@ }, "postId": { "deprecated": true, - "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.", + "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -1475,14 +1475,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" }, @@ -1526,14 +1526,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" }, @@ -2032,14 +2032,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -2184,14 +2184,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -2228,14 +2228,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -2269,14 +2269,14 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" }, "postId": { "deprecated": true, - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -2303,7 +2303,7 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", "location": "path", "required": true, "type": "string" @@ -2321,7 +2321,7 @@ }, "postId": { "deprecated": true, - "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.", + "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.", "location": "query", "type": "string" } @@ -2413,12 +2413,12 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, "postId": { - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -2455,12 +2455,12 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, "postId": { - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -2498,12 +2498,12 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, "postId": { - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -2538,12 +2538,12 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, "postId": { - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -2571,7 +2571,7 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, @@ -2587,7 +2587,7 @@ "type": "string" }, "postId": { - "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.", + "description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -2676,12 +2676,12 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, "postId": { - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -2726,12 +2726,12 @@ "type": "string" }, "itemId": { - "description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", + "description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.", "location": "query", "type": "string" }, "postId": { - "description": "Optional. Deprecated, use item_id instead.", + "description": "Optional. Deprecated, use `item_id` instead.", "location": "path", "required": true, "type": "string" @@ -3695,7 +3695,7 @@ } } }, - "revision": "20240713", + "revision": "20240911", "rootUrl": "https://classroom.googleapis.com/", "schemas": { "AddOnAttachment": { @@ -3727,7 +3727,7 @@ "type": "string" }, "itemId": { - "description": "Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.", + "description": "Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.", "type": "string" }, "maxPoints": { @@ -3737,20 +3737,20 @@ }, "postId": { "deprecated": true, - "description": "Immutable. Deprecated, use item_id instead.", + "description": "Immutable. Deprecated, use `item_id` instead.", "type": "string" }, "studentViewUri": { "$ref": "EmbedUri", - "description": "Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set." + "description": "Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set." }, "studentWorkReviewUri": { "$ref": "EmbedUri", - "description": "URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded." + "description": "URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded." }, "teacherViewUri": { "$ref": "EmbedUri", - "description": "Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set." + "description": "Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set." }, "title": { "description": "Required. Title of this attachment. The title must be between 1 and 1000 characters.", @@ -3800,12 +3800,12 @@ "type": "string" }, "itemId": { - "description": "Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.", + "description": "Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.", "type": "string" }, "postId": { "deprecated": true, - "description": "Immutable. Deprecated, use item_id instead.", + "description": "Immutable. Deprecated, use `item_id` instead.", "type": "string" }, "studentContext": { @@ -3978,12 +3978,12 @@ "type": "string" }, "itemId": { - "description": "Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.", + "description": "Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.", "type": "string" }, "postId": { "deprecated": true, - "description": "Immutable. Deprecated, use item_id instead.", + "description": "Immutable. Deprecated, use `item_id` instead.", "type": "string" } }, diff --git a/classroom/v1/classroom-gen.go b/classroom/v1/classroom-gen.go index 39382a1f488..57cd7ebcc25 100644 --- a/classroom/v1/classroom-gen.go +++ b/classroom/v1/classroom-gen.go @@ -514,8 +514,8 @@ type AddOnAttachment struct { // Id: Immutable. Classroom-assigned identifier for this attachment, unique per // post. Id string `json:"id,omitempty"` - // ItemId: Immutable. Identifier of the announcement, courseWork, or - // courseWorkMaterial under which the attachment is attached. Unique per + // ItemId: Immutable. Identifier of the `Announcement`, `CourseWork`, or + // `CourseWorkMaterial` under which the attachment is attached. Unique per // course. ItemId string `json:"itemId,omitempty"` // MaxPoints: Maximum grade for this attachment. Can only be set if @@ -524,22 +524,24 @@ type AddOnAttachment struct { // integer value. When set to zero, the attachment will not support grade // passback. MaxPoints float64 `json:"maxPoints,omitempty"` - // PostId: Immutable. Deprecated, use item_id instead. + // PostId: Immutable. Deprecated, use `item_id` instead. PostId string `json:"postId,omitempty"` // StudentViewUri: Required. URI to show the student view of the attachment. - // The URI will be opened in an iframe with the `courseId`, `postId`, and - // `attachmentId` query parameters set. + // The URI will be opened in an iframe with the `courseId`, `itemId`, + // `itemType`, and `attachmentId` query parameters set. StudentViewUri *EmbedUri `json:"studentViewUri,omitempty"` // StudentWorkReviewUri: URI for the teacher to see student work on the // attachment, if applicable. The URI will be opened in an iframe with the - // `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters - // set. This is the same `submissionId` returned by - // google.classroom.AddOns.GetAddOnContext when a student views the attachment. - // If the URI is omitted or removed, `max_points` will also be discarded. + // `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query + // parameters set. This is the same `submissionId` returned in the + // `AddOnContext.studentContext` + // (//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext + // ) field when a student views the attachment. If the URI is omitted or + // removed, `max_points` will also be discarded. StudentWorkReviewUri *EmbedUri `json:"studentWorkReviewUri,omitempty"` // TeacherViewUri: Required. URI to show the teacher view of the attachment. - // The URI will be opened in an iframe with the `courseId`, `postId`, and - // `attachmentId` query parameters set. + // The URI will be opened in an iframe with the `courseId`, `itemId`, + // `itemType`, and `attachmentId` query parameters set. TeacherViewUri *EmbedUri `json:"teacherViewUri,omitempty"` // Title: Required. Title of this attachment. The title must be between 1 and // 1000 characters. @@ -636,10 +638,10 @@ func (s *AddOnAttachmentStudentSubmission) UnmarshalJSON(data []byte) error { type AddOnContext struct { // CourseId: Immutable. Identifier of the course. CourseId string `json:"courseId,omitempty"` - // ItemId: Immutable. Identifier of the announcement, courseWork, or - // courseWorkMaterial under which the attachment is attached. + // ItemId: Immutable. Identifier of the `Announcement`, `CourseWork`, or + // `CourseWorkMaterial` under which the attachment is attached. ItemId string `json:"itemId,omitempty"` - // PostId: Immutable. Deprecated, use item_id instead. + // PostId: Immutable. Deprecated, use `item_id` instead. PostId string `json:"postId,omitempty"` // StudentContext: Add-on context corresponding to the requesting user's role // as a student. Its presence implies that the requesting user is a student in @@ -860,10 +862,10 @@ type CopyHistory struct { AttachmentId string `json:"attachmentId,omitempty"` // CourseId: Immutable. Identifier of the course. CourseId string `json:"courseId,omitempty"` - // ItemId: Immutable. Identifier of the announcement, courseWork, or - // courseWorkMaterial under which the attachment is attached. + // ItemId: Immutable. Identifier of the `Announcement`, `CourseWork`, or + // `CourseWorkMaterial` under which the attachment is attached. ItemId string `json:"itemId,omitempty"` - // PostId: Immutable. Deprecated, use item_id instead. + // PostId: Immutable. Deprecated, use `item_id` instead. PostId string `json:"postId,omitempty"` // ForceSendFields is a list of field names (e.g. "AttachmentId") to // unconditionally include in API requests. By default, fields with empty or @@ -4456,9 +4458,9 @@ type CoursesAnnouncementsGetAddOnContextCall struct { // `NOT_FOUND` if one of the identified resources does not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesAnnouncementsService) GetAddOnContext(courseId string, itemId string) *CoursesAnnouncementsGetAddOnContextCall { c := &CoursesAnnouncementsGetAddOnContextCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -4486,7 +4488,7 @@ func (c *CoursesAnnouncementsGetAddOnContextCall) AttachmentId(attachmentId stri return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesAnnouncementsGetAddOnContextCall) PostId(postId string) *CoursesAnnouncementsGetAddOnContextCall { c.urlParams_.Set("postId", postId) @@ -5026,9 +5028,9 @@ type CoursesAnnouncementsAddOnAttachmentsCreateCall struct { // identified resources does not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which to create the attachment. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which to create the attachment. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesAnnouncementsAddOnAttachmentsService) Create(courseId string, itemId string, addonattachment *AddOnAttachment) *CoursesAnnouncementsAddOnAttachmentsCreateCall { c := &CoursesAnnouncementsAddOnAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -5049,7 +5051,7 @@ func (c *CoursesAnnouncementsAddOnAttachmentsCreateCall) AddOnToken(addOnToken s return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesAnnouncementsAddOnAttachmentsCreateCall) PostId(postId string) *CoursesAnnouncementsAddOnAttachmentsCreateCall { c.urlParams_.Set("postId", postId) @@ -5158,9 +5160,9 @@ type CoursesAnnouncementsAddOnAttachmentsDeleteCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesAnnouncementsAddOnAttachmentsService) Delete(courseId string, itemId string, attachmentId string) *CoursesAnnouncementsAddOnAttachmentsDeleteCall { c := &CoursesAnnouncementsAddOnAttachmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -5169,7 +5171,7 @@ func (r *CoursesAnnouncementsAddOnAttachmentsService) Delete(courseId string, it return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesAnnouncementsAddOnAttachmentsDeleteCall) PostId(postId string) *CoursesAnnouncementsAddOnAttachmentsDeleteCall { c.urlParams_.Set("postId", postId) @@ -5275,9 +5277,9 @@ type CoursesAnnouncementsAddOnAttachmentsGetCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesAnnouncementsAddOnAttachmentsService) Get(courseId string, itemId string, attachmentId string) *CoursesAnnouncementsAddOnAttachmentsGetCall { c := &CoursesAnnouncementsAddOnAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -5286,7 +5288,7 @@ func (r *CoursesAnnouncementsAddOnAttachmentsService) Get(courseId string, itemI return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesAnnouncementsAddOnAttachmentsGetCall) PostId(postId string) *CoursesAnnouncementsAddOnAttachmentsGetCall { c.urlParams_.Set("postId", postId) @@ -5403,9 +5405,9 @@ type CoursesAnnouncementsAddOnAttachmentsListCall struct { // not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// whose attachments should be enumerated. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` whose attachments should be enumerated. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesAnnouncementsAddOnAttachmentsService) List(courseId string, itemId string) *CoursesAnnouncementsAddOnAttachmentsListCall { c := &CoursesAnnouncementsAddOnAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -5432,7 +5434,8 @@ func (c *CoursesAnnouncementsAddOnAttachmentsListCall) PageToken(pageToken strin } // PostId sets the optional parameter "postId": Identifier of the post under -// the course whose attachments to enumerate. Deprecated, use item_id instead. +// the course whose attachments to enumerate. Deprecated, use `item_id` +// instead. func (c *CoursesAnnouncementsAddOnAttachmentsListCall) PostId(postId string) *CoursesAnnouncementsAddOnAttachmentsListCall { c.urlParams_.Set("postId", postId) return c @@ -6043,9 +6046,9 @@ type CoursesCourseWorkGetAddOnContextCall struct { // `NOT_FOUND` if one of the identified resources does not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkService) GetAddOnContext(courseId string, itemId string) *CoursesCourseWorkGetAddOnContextCall { c := &CoursesCourseWorkGetAddOnContextCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -6073,7 +6076,7 @@ func (c *CoursesCourseWorkGetAddOnContextCall) AttachmentId(attachmentId string) return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkGetAddOnContextCall) PostId(postId string) *CoursesCourseWorkGetAddOnContextCall { c.urlParams_.Set("postId", postId) @@ -6623,9 +6626,9 @@ type CoursesCourseWorkAddOnAttachmentsCreateCall struct { // identified resources does not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which to create the attachment. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which to create the attachment. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkAddOnAttachmentsService) Create(courseId string, itemId string, addonattachment *AddOnAttachment) *CoursesCourseWorkAddOnAttachmentsCreateCall { c := &CoursesCourseWorkAddOnAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -6646,7 +6649,7 @@ func (c *CoursesCourseWorkAddOnAttachmentsCreateCall) AddOnToken(addOnToken stri return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkAddOnAttachmentsCreateCall) PostId(postId string) *CoursesCourseWorkAddOnAttachmentsCreateCall { c.urlParams_.Set("postId", postId) @@ -6755,9 +6758,9 @@ type CoursesCourseWorkAddOnAttachmentsDeleteCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkAddOnAttachmentsService) Delete(courseId string, itemId string, attachmentId string) *CoursesCourseWorkAddOnAttachmentsDeleteCall { c := &CoursesCourseWorkAddOnAttachmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -6766,7 +6769,7 @@ func (r *CoursesCourseWorkAddOnAttachmentsService) Delete(courseId string, itemI return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkAddOnAttachmentsDeleteCall) PostId(postId string) *CoursesCourseWorkAddOnAttachmentsDeleteCall { c.urlParams_.Set("postId", postId) @@ -6872,9 +6875,9 @@ type CoursesCourseWorkAddOnAttachmentsGetCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkAddOnAttachmentsService) Get(courseId string, itemId string, attachmentId string) *CoursesCourseWorkAddOnAttachmentsGetCall { c := &CoursesCourseWorkAddOnAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -6883,7 +6886,7 @@ func (r *CoursesCourseWorkAddOnAttachmentsService) Get(courseId string, itemId s return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkAddOnAttachmentsGetCall) PostId(postId string) *CoursesCourseWorkAddOnAttachmentsGetCall { c.urlParams_.Set("postId", postId) @@ -7000,9 +7003,9 @@ type CoursesCourseWorkAddOnAttachmentsListCall struct { // not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// whose attachments should be enumerated. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` whose attachments should be enumerated. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkAddOnAttachmentsService) List(courseId string, itemId string) *CoursesCourseWorkAddOnAttachmentsListCall { c := &CoursesCourseWorkAddOnAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -7029,7 +7032,8 @@ func (c *CoursesCourseWorkAddOnAttachmentsListCall) PageToken(pageToken string) } // PostId sets the optional parameter "postId": Identifier of the post under -// the course whose attachments to enumerate. Deprecated, use item_id instead. +// the course whose attachments to enumerate. Deprecated, use `item_id` +// instead. func (c *CoursesCourseWorkAddOnAttachmentsListCall) PostId(postId string) *CoursesCourseWorkAddOnAttachmentsListCall { c.urlParams_.Set("postId", postId) return c @@ -7301,9 +7305,9 @@ type CoursesCourseWorkAddOnAttachmentsStudentSubmissionsGetCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. // - submissionId: Identifier of the student’s submission. func (r *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsService) Get(courseId string, itemId string, attachmentId string, submissionId string) *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsGetCall { c := &CoursesCourseWorkAddOnAttachmentsStudentSubmissionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -7314,7 +7318,7 @@ func (r *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsService) Get(courseI return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsGetCall) PostId(postId string) *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsGetCall { c.urlParams_.Set("postId", postId) @@ -7435,9 +7439,9 @@ type CoursesCourseWorkAddOnAttachmentsStudentSubmissionsPatchCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. // - submissionId: Identifier of the student's submission. func (r *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsService) Patch(courseId string, itemId string, attachmentId string, submissionId string, addonattachmentstudentsubmission *AddOnAttachmentStudentSubmission) *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsPatchCall { c := &CoursesCourseWorkAddOnAttachmentsStudentSubmissionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -7449,7 +7453,7 @@ func (r *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsService) Patch(cours return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsPatchCall) PostId(postId string) *CoursesCourseWorkAddOnAttachmentsStudentSubmissionsPatchCall { c.urlParams_.Set("postId", postId) @@ -8858,9 +8862,9 @@ type CoursesCourseWorkMaterialsGetAddOnContextCall struct { // `NOT_FOUND` if one of the identified resources does not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkMaterialsService) GetAddOnContext(courseId string, itemId string) *CoursesCourseWorkMaterialsGetAddOnContextCall { c := &CoursesCourseWorkMaterialsGetAddOnContextCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -8888,7 +8892,7 @@ func (c *CoursesCourseWorkMaterialsGetAddOnContextCall) AttachmentId(attachmentI return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkMaterialsGetAddOnContextCall) PostId(postId string) *CoursesCourseWorkMaterialsGetAddOnContextCall { c.urlParams_.Set("postId", postId) @@ -9338,9 +9342,9 @@ type CoursesCourseWorkMaterialsAddOnAttachmentsCreateCall struct { // identified resources does not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which to create the attachment. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which to create the attachment. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkMaterialsAddOnAttachmentsService) Create(courseId string, itemId string, addonattachment *AddOnAttachment) *CoursesCourseWorkMaterialsAddOnAttachmentsCreateCall { c := &CoursesCourseWorkMaterialsAddOnAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -9361,7 +9365,7 @@ func (c *CoursesCourseWorkMaterialsAddOnAttachmentsCreateCall) AddOnToken(addOnT return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkMaterialsAddOnAttachmentsCreateCall) PostId(postId string) *CoursesCourseWorkMaterialsAddOnAttachmentsCreateCall { c.urlParams_.Set("postId", postId) @@ -9470,9 +9474,9 @@ type CoursesCourseWorkMaterialsAddOnAttachmentsDeleteCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkMaterialsAddOnAttachmentsService) Delete(courseId string, itemId string, attachmentId string) *CoursesCourseWorkMaterialsAddOnAttachmentsDeleteCall { c := &CoursesCourseWorkMaterialsAddOnAttachmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -9481,7 +9485,7 @@ func (r *CoursesCourseWorkMaterialsAddOnAttachmentsService) Delete(courseId stri return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkMaterialsAddOnAttachmentsDeleteCall) PostId(postId string) *CoursesCourseWorkMaterialsAddOnAttachmentsDeleteCall { c.urlParams_.Set("postId", postId) @@ -9587,9 +9591,9 @@ type CoursesCourseWorkMaterialsAddOnAttachmentsGetCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// under which the attachment is attached. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` under which the attachment is attached. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkMaterialsAddOnAttachmentsService) Get(courseId string, itemId string, attachmentId string) *CoursesCourseWorkMaterialsAddOnAttachmentsGetCall { c := &CoursesCourseWorkMaterialsAddOnAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -9598,7 +9602,7 @@ func (r *CoursesCourseWorkMaterialsAddOnAttachmentsService) Get(courseId string, return c } -// PostId sets the optional parameter "postId": Deprecated, use item_id +// PostId sets the optional parameter "postId": Deprecated, use `item_id` // instead. func (c *CoursesCourseWorkMaterialsAddOnAttachmentsGetCall) PostId(postId string) *CoursesCourseWorkMaterialsAddOnAttachmentsGetCall { c.urlParams_.Set("postId", postId) @@ -9715,9 +9719,9 @@ type CoursesCourseWorkMaterialsAddOnAttachmentsListCall struct { // not exist. // // - courseId: Identifier of the course. -// - itemId: Identifier of the announcement, courseWork, or courseWorkMaterial -// whose attachments should be enumerated. This field is required, but is not -// marked as such while we are migrating from post_id. +// - itemId: Identifier of the `Announcement`, `CourseWork`, or +// `CourseWorkMaterial` whose attachments should be enumerated. This field is +// required, but is not marked as such while we are migrating from post_id. func (r *CoursesCourseWorkMaterialsAddOnAttachmentsService) List(courseId string, itemId string) *CoursesCourseWorkMaterialsAddOnAttachmentsListCall { c := &CoursesCourseWorkMaterialsAddOnAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -9744,7 +9748,8 @@ func (c *CoursesCourseWorkMaterialsAddOnAttachmentsListCall) PageToken(pageToken } // PostId sets the optional parameter "postId": Identifier of the post under -// the course whose attachments to enumerate. Deprecated, use item_id instead. +// the course whose attachments to enumerate. Deprecated, use `item_id` +// instead. func (c *CoursesCourseWorkMaterialsAddOnAttachmentsListCall) PostId(postId string) *CoursesCourseWorkMaterialsAddOnAttachmentsListCall { c.urlParams_.Set("postId", postId) return c @@ -10017,7 +10022,7 @@ type CoursesPostsGetAddOnContextCall struct { // `NOT_FOUND` if one of the identified resources does not exist. // // - courseId: Identifier of the course. -// - postId: Optional. Deprecated, use item_id instead. +// - postId: Optional. Deprecated, use `item_id` instead. func (r *CoursesPostsService) GetAddOnContext(courseId string, postId string) *CoursesPostsGetAddOnContextCall { c := &CoursesPostsGetAddOnContextCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -10045,10 +10050,10 @@ func (c *CoursesPostsGetAddOnContextCall) AttachmentId(attachmentId string) *Cou return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial under which the attachment is attached. -// This field is required, but is not marked as such while we are migrating -// from post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the +// attachment is attached. This field is required, but is not marked as such +// while we are migrating from post_id. func (c *CoursesPostsGetAddOnContextCall) ItemId(itemId string) *CoursesPostsGetAddOnContextCall { c.urlParams_.Set("itemId", itemId) return c @@ -10161,7 +10166,7 @@ type CoursesPostsAddOnAttachmentsCreateCall struct { // identified resources does not exist. // // - courseId: Identifier of the course. -// - postId: Optional. Deprecated, use item_id instead. +// - postId: Optional. Deprecated, use `item_id` instead. func (r *CoursesPostsAddOnAttachmentsService) Create(courseId string, postId string, addonattachment *AddOnAttachment) *CoursesPostsAddOnAttachmentsCreateCall { c := &CoursesPostsAddOnAttachmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -10182,10 +10187,10 @@ func (c *CoursesPostsAddOnAttachmentsCreateCall) AddOnToken(addOnToken string) * return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial under which to create the attachment. This -// field is required, but is not marked as such while we are migrating from -// post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create +// the attachment. This field is required, but is not marked as such while we +// are migrating from post_id. func (c *CoursesPostsAddOnAttachmentsCreateCall) ItemId(itemId string) *CoursesPostsAddOnAttachmentsCreateCall { c.urlParams_.Set("itemId", itemId) return c @@ -10293,7 +10298,7 @@ type CoursesPostsAddOnAttachmentsDeleteCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - postId: Optional. Deprecated, use item_id instead. +// - postId: Optional. Deprecated, use `item_id` instead. func (r *CoursesPostsAddOnAttachmentsService) Delete(courseId string, postId string, attachmentId string) *CoursesPostsAddOnAttachmentsDeleteCall { c := &CoursesPostsAddOnAttachmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -10302,10 +10307,10 @@ func (r *CoursesPostsAddOnAttachmentsService) Delete(courseId string, postId str return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial under which the attachment is attached. -// This field is required, but is not marked as such while we are migrating -// from post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the +// attachment is attached. This field is required, but is not marked as such +// while we are migrating from post_id. func (c *CoursesPostsAddOnAttachmentsDeleteCall) ItemId(itemId string) *CoursesPostsAddOnAttachmentsDeleteCall { c.urlParams_.Set("itemId", itemId) return c @@ -10410,7 +10415,7 @@ type CoursesPostsAddOnAttachmentsGetCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - postId: Optional. Deprecated, use item_id instead. +// - postId: Optional. Deprecated, use `item_id` instead. func (r *CoursesPostsAddOnAttachmentsService) Get(courseId string, postId string, attachmentId string) *CoursesPostsAddOnAttachmentsGetCall { c := &CoursesPostsAddOnAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -10419,10 +10424,10 @@ func (r *CoursesPostsAddOnAttachmentsService) Get(courseId string, postId string return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial under which the attachment is attached. -// This field is required, but is not marked as such while we are migrating -// from post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the +// attachment is attached. This field is required, but is not marked as such +// while we are migrating from post_id. func (c *CoursesPostsAddOnAttachmentsGetCall) ItemId(itemId string) *CoursesPostsAddOnAttachmentsGetCall { c.urlParams_.Set("itemId", itemId) return c @@ -10539,7 +10544,7 @@ type CoursesPostsAddOnAttachmentsListCall struct { // // - courseId: Identifier of the course. // - postId: Optional. Identifier of the post under the course whose -// attachments to enumerate. Deprecated, use item_id instead. +// attachments to enumerate. Deprecated, use `item_id` instead. func (r *CoursesPostsAddOnAttachmentsService) List(courseId string, postId string) *CoursesPostsAddOnAttachmentsListCall { c := &CoursesPostsAddOnAttachmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.courseId = courseId @@ -10547,10 +10552,10 @@ func (r *CoursesPostsAddOnAttachmentsService) List(courseId string, postId strin return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial whose attachments should be enumerated. -// This field is required, but is not marked as such while we are migrating -// from post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments +// should be enumerated. This field is required, but is not marked as such +// while we are migrating from post_id. func (c *CoursesPostsAddOnAttachmentsListCall) ItemId(itemId string) *CoursesPostsAddOnAttachmentsListCall { c.urlParams_.Set("itemId", itemId) return c @@ -10840,7 +10845,7 @@ type CoursesPostsAddOnAttachmentsStudentSubmissionsGetCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - postId: Optional. Deprecated, use item_id instead. +// - postId: Optional. Deprecated, use `item_id` instead. // - submissionId: Identifier of the student’s submission. func (r *CoursesPostsAddOnAttachmentsStudentSubmissionsService) Get(courseId string, postId string, attachmentId string, submissionId string) *CoursesPostsAddOnAttachmentsStudentSubmissionsGetCall { c := &CoursesPostsAddOnAttachmentsStudentSubmissionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -10851,10 +10856,10 @@ func (r *CoursesPostsAddOnAttachmentsStudentSubmissionsService) Get(courseId str return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial under which the attachment is attached. -// This field is required, but is not marked as such while we are migrating -// from post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the +// attachment is attached. This field is required, but is not marked as such +// while we are migrating from post_id. func (c *CoursesPostsAddOnAttachmentsStudentSubmissionsGetCall) ItemId(itemId string) *CoursesPostsAddOnAttachmentsStudentSubmissionsGetCall { c.urlParams_.Set("itemId", itemId) return c @@ -10974,7 +10979,7 @@ type CoursesPostsAddOnAttachmentsStudentSubmissionsPatchCall struct { // // - attachmentId: Identifier of the attachment. // - courseId: Identifier of the course. -// - postId: Optional. Deprecated, use item_id instead. +// - postId: Optional. Deprecated, use `item_id` instead. // - submissionId: Identifier of the student's submission. func (r *CoursesPostsAddOnAttachmentsStudentSubmissionsService) Patch(courseId string, postId string, attachmentId string, submissionId string, addonattachmentstudentsubmission *AddOnAttachmentStudentSubmission) *CoursesPostsAddOnAttachmentsStudentSubmissionsPatchCall { c := &CoursesPostsAddOnAttachmentsStudentSubmissionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -10986,10 +10991,10 @@ func (r *CoursesPostsAddOnAttachmentsStudentSubmissionsService) Patch(courseId s return c } -// ItemId sets the optional parameter "itemId": Identifier of the announcement, -// courseWork, or courseWorkMaterial under which the attachment is attached. -// This field is required, but is not marked as such while we are migrating -// from post_id. +// ItemId sets the optional parameter "itemId": Identifier of the +// `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the +// attachment is attached. This field is required, but is not marked as such +// while we are migrating from post_id. func (c *CoursesPostsAddOnAttachmentsStudentSubmissionsPatchCall) ItemId(itemId string) *CoursesPostsAddOnAttachmentsStudentSubmissionsPatchCall { c.urlParams_.Set("itemId", itemId) return c diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index 4c2b991c3dc..380f9e24a7f 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -154,11 +154,6 @@ "required": true, "type": "string" }, - "integrator": { - "description": "Optional. Resource name of the integrator.", - "location": "query", - "type": "string" - }, "pageSize": { "description": "Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.", "format": "int32", @@ -1971,121 +1966,6 @@ } } }, - "integrators": { - "methods": { - "listSubscribers": { - "description": "Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.", - "flatPath": "v1/integrators/{integratorsId}:listSubscribers", - "httpMethod": "GET", - "id": "cloudchannel.integrators.listSubscribers", - "parameterOrder": [ - "integrator" - ], - "parameters": { - "account": { - "description": "Optional. Resource name of the account.", - "location": "query", - "type": "string" - }, - "integrator": { - "description": "Optional. Resource name of the integrator.", - "location": "path", - "pattern": "^integrators/[^/]+$", - "required": true, - "type": "string" - }, - "pageSize": { - "description": "Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.", - "format": "int32", - "location": "query", - "type": "integer" - }, - "pageToken": { - "description": "Optional. A page token, received from a previous `ListSubscribers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscribers` must match the call that provided the page token.", - "location": "query", - "type": "string" - } - }, - "path": "v1/{+integrator}:listSubscribers", - "response": { - "$ref": "GoogleCloudChannelV1ListSubscribersResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/apps.order" - ] - }, - "registerSubscriber": { - "description": "Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account. After you create a subscriber, you get the events through SubscriberEvent Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name with the registered service email address.", - "flatPath": "v1/integrators/{integratorsId}:registerSubscriber", - "httpMethod": "POST", - "id": "cloudchannel.integrators.registerSubscriber", - "parameterOrder": [ - "integrator" - ], - "parameters": { - "account": { - "description": "Optional. Resource name of the account.", - "location": "query", - "type": "string" - }, - "integrator": { - "description": "Optional. Resource name of the integrator.", - "location": "path", - "pattern": "^integrators/[^/]+$", - "required": true, - "type": "string" - }, - "serviceAccount": { - "description": "Required. Service account that provides subscriber access to the registered topic.", - "location": "query", - "type": "string" - } - }, - "path": "v1/{+integrator}:registerSubscriber", - "response": { - "$ref": "GoogleCloudChannelV1RegisterSubscriberResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/apps.order" - ] - }, - "unregisterSubscriber": { - "description": "Unregisters a service account with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.", - "flatPath": "v1/integrators/{integratorsId}:unregisterSubscriber", - "httpMethod": "POST", - "id": "cloudchannel.integrators.unregisterSubscriber", - "parameterOrder": [ - "integrator" - ], - "parameters": { - "account": { - "description": "Optional. Resource name of the account.", - "location": "query", - "type": "string" - }, - "integrator": { - "description": "Optional. Resource name of the integrator.", - "location": "path", - "pattern": "^integrators/[^/]+$", - "required": true, - "type": "string" - }, - "serviceAccount": { - "description": "Required. Service account to unregister from subscriber access to the topic.", - "location": "query", - "type": "string" - } - }, - "path": "v1/{+integrator}:unregisterSubscriber", - "response": { - "$ref": "GoogleCloudChannelV1UnregisterSubscriberResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/apps.order" - ] - } - } - }, "operations": { "methods": { "cancel": { @@ -2303,7 +2183,7 @@ } } }, - "revision": "20240909", + "revision": "20240913", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -4363,10 +4243,6 @@ "description": "Request Message for RegisterSubscriber.", "id": "GoogleCloudChannelV1RegisterSubscriberRequest", "properties": { - "integrator": { - "description": "Optional. Resource name of the integrator.", - "type": "string" - }, "serviceAccount": { "description": "Required. Service account that provides subscriber access to the registered topic.", "type": "string" @@ -4941,10 +4817,6 @@ "description": "Request Message for UnregisterSubscriber.", "id": "GoogleCloudChannelV1UnregisterSubscriberRequest", "properties": { - "integrator": { - "description": "Optional. Resource name of the integrator.", - "type": "string" - }, "serviceAccount": { "description": "Required. Service account to unregister from subscriber access to the topic.", "type": "string" diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index 779967e36dc..2d380633e3c 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -144,7 +144,6 @@ func New(client *http.Client) (*Service, error) { } s := &Service{client: client, BasePath: basePath} s.Accounts = NewAccountsService(s) - s.Integrators = NewIntegratorsService(s) s.Operations = NewOperationsService(s) s.Products = NewProductsService(s) return s, nil @@ -157,8 +156,6 @@ type Service struct { Accounts *AccountsService - Integrators *IntegratorsService - Operations *OperationsService Products *ProductsService @@ -312,15 +309,6 @@ type AccountsSkuGroupsBillableSkusService struct { s *Service } -func NewIntegratorsService(s *Service) *IntegratorsService { - rs := &IntegratorsService{s: s} - return rs -} - -type IntegratorsService struct { - s *Service -} - func NewOperationsService(s *Service) *OperationsService { rs := &OperationsService{s: s} return rs @@ -2926,20 +2914,18 @@ func (s GoogleCloudChannelV1QueryEligibleBillingAccountsResponse) MarshalJSON() // GoogleCloudChannelV1RegisterSubscriberRequest: Request Message for // RegisterSubscriber. type GoogleCloudChannelV1RegisterSubscriberRequest struct { - // Integrator: Optional. Resource name of the integrator. - Integrator string `json:"integrator,omitempty"` // ServiceAccount: Required. Service account that provides subscriber access to // the registered topic. ServiceAccount string `json:"serviceAccount,omitempty"` - // ForceSendFields is a list of field names (e.g. "Integrator") to + // ForceSendFields is a list of field names (e.g. "ServiceAccount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Integrator") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "ServiceAccount") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -3807,20 +3793,18 @@ func (s GoogleCloudChannelV1TrialSettings) MarshalJSON() ([]byte, error) { // GoogleCloudChannelV1UnregisterSubscriberRequest: Request Message for // UnregisterSubscriber. type GoogleCloudChannelV1UnregisterSubscriberRequest struct { - // Integrator: Optional. Resource name of the integrator. - Integrator string `json:"integrator,omitempty"` // ServiceAccount: Required. Service account to unregister from subscriber // access to the topic. ServiceAccount string `json:"serviceAccount,omitempty"` - // ForceSendFields is a list of field names (e.g. "Integrator") to + // ForceSendFields is a list of field names (e.g. "ServiceAccount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Integrator") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "ServiceAccount") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -5342,13 +5326,6 @@ func (r *AccountsService) ListSubscribers(account string) *AccountsListSubscribe return c } -// Integrator sets the optional parameter "integrator": Resource name of the -// integrator. -func (c *AccountsListSubscribersCall) Integrator(integrator string) *AccountsListSubscribersCall { - c.urlParams_.Set("integrator", integrator) - return c -} - // PageSize sets the optional parameter "pageSize": The maximum number of // service accounts to return. The service may return fewer than this value. If // unspecified, returns at most 100 service accounts. The maximum value is @@ -12471,409 +12448,6 @@ func (c *AccountsSkuGroupsBillableSkusListCall) Pages(ctx context.Context, f fun } } -type IntegratorsListSubscribersCall struct { - s *Service - integrator string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// ListSubscribers: Lists service accounts with subscriber privileges on the -// Cloud Pub/Sub topic created for this Channel Services account. Possible -// error codes: * PERMISSION_DENIED: The reseller account making the request -// and the provided reseller account are different, or the impersonated user is -// not a super admin. * INVALID_ARGUMENT: Required request parameters are -// missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * -// INTERNAL: Any non-user error related to a technical issue in the backend. -// Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a -// technical issue in the backend. Contact Cloud Channel support. Return value: -// A list of service email addresses. -// -// - integrator: Optional. Resource name of the integrator. -func (r *IntegratorsService) ListSubscribers(integrator string) *IntegratorsListSubscribersCall { - c := &IntegratorsListSubscribersCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.integrator = integrator - return c -} - -// Account sets the optional parameter "account": Resource name of the account. -func (c *IntegratorsListSubscribersCall) Account(account string) *IntegratorsListSubscribersCall { - c.urlParams_.Set("account", account) - return c -} - -// PageSize sets the optional parameter "pageSize": The maximum number of -// service accounts to return. The service may return fewer than this value. If -// unspecified, returns at most 100 service accounts. The maximum value is -// 1000; the server will coerce values above 1000. -func (c *IntegratorsListSubscribersCall) PageSize(pageSize int64) *IntegratorsListSubscribersCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": A page token, received -// from a previous `ListSubscribers` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `ListSubscribers` must match the call that provided the page token. -func (c *IntegratorsListSubscribersCall) PageToken(pageToken string) *IntegratorsListSubscribersCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *IntegratorsListSubscribersCall) Fields(s ...googleapi.Field) *IntegratorsListSubscribersCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// IfNoneMatch sets an optional parameter which makes the operation fail if the -// object's ETag matches the given value. This is useful for getting updates -// only after the object has changed since the last request. -func (c *IntegratorsListSubscribersCall) IfNoneMatch(entityTag string) *IntegratorsListSubscribersCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *IntegratorsListSubscribersCall) Context(ctx context.Context) *IntegratorsListSubscribersCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *IntegratorsListSubscribersCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *IntegratorsListSubscribersCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } - var body io.Reader = nil - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+integrator}:listSubscribers") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "integrator": c.integrator, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "cloudchannel.integrators.listSubscribers" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudChannelV1ListSubscribersResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *IntegratorsListSubscribersCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1ListSubscribersResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleCloudChannelV1ListSubscribersResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil -} - -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *IntegratorsListSubscribersCall) Pages(ctx context.Context, f func(*GoogleCloudChannelV1ListSubscribersResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type IntegratorsRegisterSubscriberCall struct { - s *Service - integrator string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// RegisterSubscriber: Registers a service account with subscriber privileges -// on the Cloud Pub/Sub topic for this Channel Services account. After you -// create a subscriber, you get the events through SubscriberEvent Possible -// error codes: * PERMISSION_DENIED: The reseller account making the request -// and the provided reseller account are different, or the impersonated user is -// not a super admin. * INVALID_ARGUMENT: Required request parameters are -// missing or invalid. * INTERNAL: Any non-user error related to a technical -// issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user -// error related to a technical issue in the backend. Contact Cloud Channel -// support. Return value: The topic name with the registered service email -// address. -// -// - integrator: Optional. Resource name of the integrator. -func (r *IntegratorsService) RegisterSubscriber(integrator string) *IntegratorsRegisterSubscriberCall { - c := &IntegratorsRegisterSubscriberCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.integrator = integrator - return c -} - -// Account sets the optional parameter "account": Resource name of the account. -func (c *IntegratorsRegisterSubscriberCall) Account(account string) *IntegratorsRegisterSubscriberCall { - c.urlParams_.Set("account", account) - return c -} - -// ServiceAccount sets the optional parameter "serviceAccount": Required. -// Service account that provides subscriber access to the registered topic. -func (c *IntegratorsRegisterSubscriberCall) ServiceAccount(serviceAccount string) *IntegratorsRegisterSubscriberCall { - c.urlParams_.Set("serviceAccount", serviceAccount) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *IntegratorsRegisterSubscriberCall) Fields(s ...googleapi.Field) *IntegratorsRegisterSubscriberCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *IntegratorsRegisterSubscriberCall) Context(ctx context.Context) *IntegratorsRegisterSubscriberCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *IntegratorsRegisterSubscriberCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *IntegratorsRegisterSubscriberCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - var body io.Reader = nil - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+integrator}:registerSubscriber") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "integrator": c.integrator, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "cloudchannel.integrators.registerSubscriber" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudChannelV1RegisterSubscriberResponse.ServerResponse.Header or (if -// a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *IntegratorsRegisterSubscriberCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1RegisterSubscriberResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleCloudChannelV1RegisterSubscriberResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil -} - -type IntegratorsUnregisterSubscriberCall struct { - s *Service - integrator string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// UnregisterSubscriber: Unregisters a service account with subscriber -// privileges on the Cloud Pub/Sub topic created for this Channel Services -// account. If there are no service accounts left with subscriber privileges, -// this deletes the topic. You can call ListSubscribers to check for these -// accounts. Possible error codes: * PERMISSION_DENIED: The reseller account -// making the request and the provided reseller account are different, or the -// impersonated user is not a super admin. * INVALID_ARGUMENT: Required request -// parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't -// exist. * INTERNAL: Any non-user error related to a technical issue in the -// backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error -// related to a technical issue in the backend. Contact Cloud Channel support. -// Return value: The topic name that unregistered the service email address. -// Returns a success response if the service email address wasn't registered -// with the topic. -// -// - integrator: Optional. Resource name of the integrator. -func (r *IntegratorsService) UnregisterSubscriber(integrator string) *IntegratorsUnregisterSubscriberCall { - c := &IntegratorsUnregisterSubscriberCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.integrator = integrator - return c -} - -// Account sets the optional parameter "account": Resource name of the account. -func (c *IntegratorsUnregisterSubscriberCall) Account(account string) *IntegratorsUnregisterSubscriberCall { - c.urlParams_.Set("account", account) - return c -} - -// ServiceAccount sets the optional parameter "serviceAccount": Required. -// Service account to unregister from subscriber access to the topic. -func (c *IntegratorsUnregisterSubscriberCall) ServiceAccount(serviceAccount string) *IntegratorsUnregisterSubscriberCall { - c.urlParams_.Set("serviceAccount", serviceAccount) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more -// details. -func (c *IntegratorsUnregisterSubscriberCall) Fields(s ...googleapi.Field) *IntegratorsUnregisterSubscriberCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *IntegratorsUnregisterSubscriberCall) Context(ctx context.Context) *IntegratorsUnregisterSubscriberCall { - c.ctx_ = ctx - return c -} - -// Header returns a http.Header that can be modified by the caller to add -// headers to the request. -func (c *IntegratorsUnregisterSubscriberCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *IntegratorsUnregisterSubscriberCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - var body io.Reader = nil - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+integrator}:unregisterSubscriber") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "integrator": c.integrator, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "cloudchannel.integrators.unregisterSubscriber" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudChannelV1UnregisterSubscriberResponse.ServerResponse.Header or -// (if a response was returned at all) in error.(*googleapi.Error).Header. Use -// googleapi.IsNotModified to check whether the returned error was because -// http.StatusNotModified was returned. -func (c *IntegratorsUnregisterSubscriberCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1UnregisterSubscriberResponse, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("json") - if res != nil && res.StatusCode == http.StatusNotModified { - if res.Body != nil { - res.Body.Close() - } - return nil, gensupport.WrapError(&googleapi.Error{ - Code: res.StatusCode, - Header: res.Header, - }) - } - if err != nil { - return nil, err - } - defer googleapi.CloseBody(res) - if err := googleapi.CheckResponse(res); err != nil { - return nil, gensupport.WrapError(err) - } - ret := &GoogleCloudChannelV1UnregisterSubscriberResponse{ - ServerResponse: googleapi.ServerResponse{ - Header: res.Header, - HTTPStatusCode: res.StatusCode, - }, - } - target := &ret - if err := gensupport.DecodeResponse(target, res); err != nil { - return nil, err - } - return ret, nil -} - type OperationsCancelCall struct { s *Service name string diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 76dd9a4cb4a..5713e50d5d4 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -2062,7 +2062,7 @@ ] }, "listUsable": { - "description": "Retrieves an aggregated list of all usable backend services in the specified project.", + "description": "Retrieves a list of all usable backend services in the specified project.", "flatPath": "projects/{project}/global/backendServices/listUsable", "httpMethod": "GET", "id": "compute.backendServices.listUsable", @@ -14231,6 +14231,55 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.instantSnapshotGroups.getIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "insert": { "description": "inserts a Zonal InstantSnapshotGroup resource", "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups", @@ -14340,6 +14389,97 @@ "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/compute.readonly" ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.instantSnapshotGroups.setIamPolicy", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy", + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.instantSnapshotGroups.testIamPermissions", + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, @@ -23957,7 +24097,7 @@ ] }, "listUsable": { - "description": "Retrieves an aggregated list of all usable backend services in the specified project in the given region.", + "description": "Retrieves a list of all usable backend services in the specified project in the given region.", "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", "httpMethod": "GET", "id": "compute.regionBackendServices.listUsable", @@ -28737,6 +28877,55 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "id": "compute.regionInstantSnapshotGroups.getIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "insert": { "description": "creates a Regional InstantSnapshotGroup resource", "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups", @@ -28846,6 +29035,97 @@ "https://www.googleapis.com/auth/compute", "https://www.googleapis.com/auth/compute.readonly" ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshotGroups.setIamPolicy", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy", + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.regionInstantSnapshotGroups.testIamPermissions", + "parameterOrder": [ + "project", + "region", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] } } }, @@ -45278,7 +45558,7 @@ } } }, - "revision": "20240827", + "revision": "20240903", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -60627,6 +60907,10 @@ ], "type": "string" }, + "multiMig": { + "description": "URL to the multi-MIG that this Managed Instance Group belongs to.", + "type": "string" + }, "name": { "annotations": { "required": [ @@ -69632,6 +69916,9 @@ ], "type": "string" }, + "currentActionDetails": { + "$ref": "ManagedInstanceCurrentActionDetails" + }, "id": { "description": "[Output only] The unique identifier for this resource. This field is empty when instance does not exist.", "format": "uint64", @@ -69751,6 +70038,45 @@ }, "type": "object" }, + "ManagedInstanceCurrentActionDetails": { + "id": "ManagedInstanceCurrentActionDetails", + "properties": { + "methodName": { + "type": "string" + }, + "trigger": { + "description": "[Output Only] Details of the current action that the managed instance group has scheduled for the instance. Contains trigger for the current action, and methodName in case it was triggered by API call. Possible values for trigger: - API Any API call. - PROACTIVE_UPDATE Proactive updater scheduled an update on this managed instance. - AUTOSCALING Instance being deleted/created after a decision from the Autoscaler. - REDISTRIBUTION The regional managed instance group is moving instances between zones to restore balance. - STANDBY_REFILL The managed instance group is refilling the Standby Pool (stopped/suspended virtual machines) after scale up. - MAINTENANCE Manual maintenance. - FAILED_CREATION The managed instance group is handling failed instance creation. - INSTANCE_FAILURE The managed instance group is handling instance failure, according to the Instance Lifecycle Policy. - FAILED_HEALTH_CHECK The managed instance group is handling failed health check, according to the Instance Lifecycle Policy. - TERMINATION_TIMESTAMP Instance reached termination time, thus managed instance group stops/deletes it. ", + "enum": [ + "API", + "AUTOSCALING", + "FAILED_CREATION", + "FAILED_HEALTH_CHECK", + "INSTANCE_FAILURE", + "MAINTENANCE", + "NONE", + "PROACTIVE_UPDATE", + "REDISTRIBUTION", + "STANDBY_REFILL", + "TERMINATION_TIMESTAMP" + ], + "enumDescriptions": [ + "Any API call.", + "Instance being deleted/created after a decision from the Autoscaler.", + "The managed instance group is handling failed instance creation.", + "The managed instance group is handling failed health check, according to the Instance Lifecycle Policy.", + "The managed instance group is handling instance failure, according to the Instance Lifecycle Policy.", + "Manual maintenance.", + "Default value, not visible externally.", + "Proactive updater scheduled an update on this managed instance.", + "The regional managed instance group is moving instances between zones to restore balance.", + "The managed instance group is refilling the Standby Pool (stopped/suspended virtual machines) after scale up.", + "Instance reached termination time, thus managed instance group stops/deletes it." + ], + "type": "string" + } + }, + "type": "object" + }, "ManagedInstanceInstanceFlexibilityOverride": { "id": "ManagedInstanceInstanceFlexibilityOverride", "properties": { @@ -84640,6 +84966,10 @@ "RoutePolicy": { "id": "RoutePolicy", "properties": { + "description": { + "description": "An optional description of route policy.", + "type": "string" + }, "fingerprint": { "description": "A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.", "format": "byte", @@ -93787,7 +94117,7 @@ "type": "string" }, "internalIpv6Prefix": { - "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", + "description": "The internal IPv6 address range that is owned by this subnetwork.", "type": "string" }, "ipCidrRange": { diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index e1187135b77..a2970bd9291 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -19368,6 +19368,8 @@ type InstanceGroupManager struct { // "PAGINATED" - Pagination is enabled for the group's listManagedInstances // API method. maxResults and pageToken query parameters are respected. ListManagedInstancesResults string `json:"listManagedInstancesResults,omitempty"` + // MultiMig: URL to the multi-MIG that this Managed Instance Group belongs to. + MultiMig string `json:"multiMig,omitempty"` // Name: The name of the managed instance group. The name must be 1-63 // characters long, and comply with RFC1035. Name string `json:"name,omitempty"` @@ -29611,7 +29613,8 @@ type ManagedInstance struct { // Applies only if autohealing policy has a health check specified 2. Waiting // for addition verification steps performed as post-instance creation (subject // to future extensions). - CurrentAction string `json:"currentAction,omitempty"` + CurrentAction string `json:"currentAction,omitempty"` + CurrentActionDetails *ManagedInstanceCurrentActionDetails `json:"currentActionDetails,omitempty"` // Id: [Output only] The unique identifier for this resource. This field is // empty when instance does not exist. Id uint64 `json:"id,omitempty,string"` @@ -29735,6 +29738,64 @@ func (s ManagedInstanceAllInstancesConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ManagedInstanceCurrentActionDetails struct { + MethodName string `json:"methodName,omitempty"` + // Trigger: [Output Only] Details of the current action that the managed + // instance group has scheduled for the instance. Contains trigger for the + // current action, and methodName in case it was triggered by API call. + // Possible values for trigger: - API Any API call. - PROACTIVE_UPDATE + // Proactive updater scheduled an update on this managed instance. - + // AUTOSCALING Instance being deleted/created after a decision from the + // Autoscaler. - REDISTRIBUTION The regional managed instance group is moving + // instances between zones to restore balance. - STANDBY_REFILL The managed + // instance group is refilling the Standby Pool (stopped/suspended virtual + // machines) after scale up. - MAINTENANCE Manual maintenance. - + // FAILED_CREATION The managed instance group is handling failed instance + // creation. - INSTANCE_FAILURE The managed instance group is handling instance + // failure, according to the Instance Lifecycle Policy. - FAILED_HEALTH_CHECK + // The managed instance group is handling failed health check, according to the + // Instance Lifecycle Policy. - TERMINATION_TIMESTAMP Instance reached + // termination time, thus managed instance group stops/deletes it. + // + // Possible values: + // "API" - Any API call. + // "AUTOSCALING" - Instance being deleted/created after a decision from the + // Autoscaler. + // "FAILED_CREATION" - The managed instance group is handling failed instance + // creation. + // "FAILED_HEALTH_CHECK" - The managed instance group is handling failed + // health check, according to the Instance Lifecycle Policy. + // "INSTANCE_FAILURE" - The managed instance group is handling instance + // failure, according to the Instance Lifecycle Policy. + // "MAINTENANCE" - Manual maintenance. + // "NONE" - Default value, not visible externally. + // "PROACTIVE_UPDATE" - Proactive updater scheduled an update on this managed + // instance. + // "REDISTRIBUTION" - The regional managed instance group is moving instances + // between zones to restore balance. + // "STANDBY_REFILL" - The managed instance group is refilling the Standby + // Pool (stopped/suspended virtual machines) after scale up. + // "TERMINATION_TIMESTAMP" - Instance reached termination time, thus managed + // instance group stops/deletes it. + Trigger string `json:"trigger,omitempty"` + // ForceSendFields is a list of field names (e.g. "MethodName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MethodName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ManagedInstanceCurrentActionDetails) MarshalJSON() ([]byte, error) { + type NoMethod ManagedInstanceCurrentActionDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ManagedInstanceInstanceFlexibilityOverride struct { // MachineType: The machine type to be used for this instance. MachineType string `json:"machineType,omitempty"` @@ -45749,6 +45810,8 @@ func (s RouteListWarningData) MarshalJSON() ([]byte, error) { } type RoutePolicy struct { + // Description: An optional description of route policy. + Description string `json:"description,omitempty"` // Fingerprint: A fingerprint for the Route Policy being applied to this // Router, which is essentially a hash of the Route Policy used for optimistic // locking. The fingerprint is initially generated by Compute Engine and @@ -45768,13 +45831,13 @@ type RoutePolicy struct { // "ROUTE_POLICY_TYPE_EXPORT" - The Route Policy is an Export Policy. // "ROUTE_POLICY_TYPE_IMPORT" - The Route Policy is an Import Policy. Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Fingerprint") to + // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Fingerprint") to include in API + // NullFields is a list of field names (e.g. "Description") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -55497,8 +55560,8 @@ type Subnetwork struct { // Id: [Output Only] The unique identifier for the resource. This identifier is // defined by the server. Id uint64 `json:"id,omitempty,string"` - // InternalIpv6Prefix: [Output Only] The internal IPv6 address range that is - // assigned to this subnetwork. + // InternalIpv6Prefix: The internal IPv6 address range that is owned by this + // subnetwork. InternalIpv6Prefix string `json:"internalIpv6Prefix,omitempty"` // IpCidrRange: The range of internal addresses that are owned by this // subnetwork. Provide this property when you create the subnetwork. For diff --git a/compute/v0.alpha/compute2-gen.go b/compute/v0.alpha/compute2-gen.go index 49619b2c933..782d35de5fb 100644 --- a/compute/v0.alpha/compute2-gen.go +++ b/compute/v0.alpha/compute2-gen.go @@ -5843,8 +5843,8 @@ type BackendServicesListUsableCall struct { header_ http.Header } -// ListUsable: Retrieves an aggregated list of all usable backend services in -// the specified project. +// ListUsable: Retrieves a list of all usable backend services in the specified +// project. // // - project: Project ID for this request. func (r *BackendServicesService) ListUsable(project string) *BackendServicesListUsableCall { @@ -40893,6 +40893,129 @@ func (c *InstantSnapshotGroupsGetCall) Do(opts ...googleapi.CallOption) (*Instan return ret, nil } +type InstantSnapshotGroupsGetIamPolicyCall struct { + s *Service + project string + zone string + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. May be empty if +// no such policy or resource exists. +// +// - project: Project ID for this request. +// - resource: Name or id of the resource for this request. +// - zone: The name of the zone for this request. +func (r *InstantSnapshotGroupsService) GetIamPolicy(project string, zone string, resource string) *InstantSnapshotGroupsGetIamPolicyCall { + c := &InstantSnapshotGroupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.zone = zone + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "optionsRequestedPolicyVersion": Requested IAM Policy version. +func (c *InstantSnapshotGroupsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *InstantSnapshotGroupsGetIamPolicyCall { + c.urlParams_.Set("optionsRequestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *InstantSnapshotGroupsGetIamPolicyCall) Fields(s ...googleapi.Field) *InstantSnapshotGroupsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *InstantSnapshotGroupsGetIamPolicyCall) IfNoneMatch(entityTag string) *InstantSnapshotGroupsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InstantSnapshotGroupsGetIamPolicyCall) Context(ctx context.Context) *InstantSnapshotGroupsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *InstantSnapshotGroupsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstantSnapshotGroupsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "zone": c.zone, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.instantSnapshotGroups.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *InstantSnapshotGroupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type InstantSnapshotGroupsInsertCall struct { s *Service project string @@ -41232,6 +41355,227 @@ func (c *InstantSnapshotGroupsListCall) Pages(ctx context.Context, f func(*ListI } } +type InstantSnapshotGroupsSetIamPolicyCall struct { + s *Service + project string + zone string + resource string + zonesetpolicyrequest *ZoneSetPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. +// +// - project: Project ID for this request. +// - resource: Name or id of the resource for this request. +// - zone: The name of the zone for this request. +func (r *InstantSnapshotGroupsService) SetIamPolicy(project string, zone string, resource string, zonesetpolicyrequest *ZoneSetPolicyRequest) *InstantSnapshotGroupsSetIamPolicyCall { + c := &InstantSnapshotGroupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.zone = zone + c.resource = resource + c.zonesetpolicyrequest = zonesetpolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *InstantSnapshotGroupsSetIamPolicyCall) Fields(s ...googleapi.Field) *InstantSnapshotGroupsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InstantSnapshotGroupsSetIamPolicyCall) Context(ctx context.Context) *InstantSnapshotGroupsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *InstantSnapshotGroupsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstantSnapshotGroupsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.zonesetpolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "zone": c.zone, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.instantSnapshotGroups.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *InstantSnapshotGroupsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type InstantSnapshotGroupsTestIamPermissionsCall struct { + s *Service + project string + zone string + resource string + testpermissionsrequest *TestPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. +// +// - project: Project ID for this request. +// - resource: Name or id of the resource for this request. +// - zone: The name of the zone for this request. +func (r *InstantSnapshotGroupsService) TestIamPermissions(project string, zone string, resource string, testpermissionsrequest *TestPermissionsRequest) *InstantSnapshotGroupsTestIamPermissionsCall { + c := &InstantSnapshotGroupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.zone = zone + c.resource = resource + c.testpermissionsrequest = testpermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *InstantSnapshotGroupsTestIamPermissionsCall) Fields(s ...googleapi.Field) *InstantSnapshotGroupsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InstantSnapshotGroupsTestIamPermissionsCall) Context(ctx context.Context) *InstantSnapshotGroupsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *InstantSnapshotGroupsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstantSnapshotGroupsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testpermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "zone": c.zone, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.instantSnapshotGroups.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestPermissionsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *InstantSnapshotGroupsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &TestPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type InstantSnapshotsAggregatedListCall struct { s *Service project string @@ -69801,8 +70145,8 @@ type RegionBackendServicesListUsableCall struct { header_ http.Header } -// ListUsable: Retrieves an aggregated list of all usable backend services in -// the specified project in the given region. +// ListUsable: Retrieves a list of all usable backend services in the specified +// project in the given region. // // - project: Project ID for this request. // - region: Name of the region scoping this request. It must be a string that diff --git a/compute/v0.alpha/compute3-gen.go b/compute/v0.alpha/compute3-gen.go index 7ccdcc7c337..b9cc385912b 100644 --- a/compute/v0.alpha/compute3-gen.go +++ b/compute/v0.alpha/compute3-gen.go @@ -12259,6 +12259,129 @@ func (c *RegionInstantSnapshotGroupsGetCall) Do(opts ...googleapi.CallOption) (* return ret, nil } +type RegionInstantSnapshotGroupsGetIamPolicyCall struct { + s *Service + project string + region string + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. May be empty if +// no such policy or resource exists. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionInstantSnapshotGroupsService) GetIamPolicy(project string, region string, resource string) *RegionInstantSnapshotGroupsGetIamPolicyCall { + c := &RegionInstantSnapshotGroupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "optionsRequestedPolicyVersion": Requested IAM Policy version. +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *RegionInstantSnapshotGroupsGetIamPolicyCall { + c.urlParams_.Set("optionsRequestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) Fields(s ...googleapi.Field) *RegionInstantSnapshotGroupsGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) IfNoneMatch(entityTag string) *RegionInstantSnapshotGroupsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) Context(ctx context.Context) *RegionInstantSnapshotGroupsGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionInstantSnapshotGroups.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RegionInstantSnapshotGroupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type RegionInstantSnapshotGroupsInsertCall struct { s *Service project string @@ -12598,6 +12721,227 @@ func (c *RegionInstantSnapshotGroupsListCall) Pages(ctx context.Context, f func( } } +type RegionInstantSnapshotGroupsSetIamPolicyCall struct { + s *Service + project string + region string + resource string + regionsetpolicyrequest *RegionSetPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionInstantSnapshotGroupsService) SetIamPolicy(project string, region string, resource string, regionsetpolicyrequest *RegionSetPolicyRequest) *RegionInstantSnapshotGroupsSetIamPolicyCall { + c := &RegionInstantSnapshotGroupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.regionsetpolicyrequest = regionsetpolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionInstantSnapshotGroupsSetIamPolicyCall) Fields(s ...googleapi.Field) *RegionInstantSnapshotGroupsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionInstantSnapshotGroupsSetIamPolicyCall) Context(ctx context.Context) *RegionInstantSnapshotGroupsSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionInstantSnapshotGroupsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionInstantSnapshotGroupsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.regionsetpolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionInstantSnapshotGroups.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *RegionInstantSnapshotGroupsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type RegionInstantSnapshotGroupsTestIamPermissionsCall struct { + s *Service + project string + region string + resource string + testpermissionsrequest *TestPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionInstantSnapshotGroupsService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *RegionInstantSnapshotGroupsTestIamPermissionsCall { + c := &RegionInstantSnapshotGroupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.testpermissionsrequest = testpermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *RegionInstantSnapshotGroupsTestIamPermissionsCall) Fields(s ...googleapi.Field) *RegionInstantSnapshotGroupsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionInstantSnapshotGroupsTestIamPermissionsCall) Context(ctx context.Context) *RegionInstantSnapshotGroupsTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *RegionInstantSnapshotGroupsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionInstantSnapshotGroupsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.testpermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionInstantSnapshotGroups.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestPermissionsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *RegionInstantSnapshotGroupsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &TestPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type RegionInstantSnapshotsDeleteCall struct { s *Service project string diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 3e7b21b4ec5..491252bb42b 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -2007,7 +2007,7 @@ ] }, "listUsable": { - "description": "Retrieves an aggregated list of all usable backend services in the specified project.", + "description": "Retrieves a list of all usable backend services in the specified project.", "flatPath": "projects/{project}/global/backendServices/listUsable", "httpMethod": "GET", "id": "compute.backendServices.listUsable", @@ -22797,7 +22797,7 @@ ] }, "listUsable": { - "description": "Retrieves an aggregated list of all usable backend services in the specified project in the given region.", + "description": "Retrieves a list of all usable backend services in the specified project in the given region.", "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", "httpMethod": "GET", "id": "compute.regionBackendServices.listUsable", @@ -41911,7 +41911,7 @@ } } }, - "revision": "20240827", + "revision": "20240903", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -44714,6 +44714,13 @@ "selfLink": { "description": "[Output Only] Server-defined URL for the resource.", "type": "string" + }, + "usedBy": { + "description": "[Output Only] List of resources referencing that backend bucket.", + "items": { + "$ref": "BackendBucketUsedBy" + }, + "type": "array" } }, "type": "object" @@ -45000,6 +45007,16 @@ }, "type": "object" }, + "BackendBucketUsedBy": { + "id": "BackendBucketUsedBy", + "properties": { + "reference": { + "description": "[Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.", + "type": "string" + } + }, + "type": "object" + }, "BackendService": { "description": "Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/beta/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/beta/regionBackendServices) For more information, see Backend Services.", "id": "BackendService", @@ -55913,6 +55930,10 @@ ], "type": "string" }, + "multiMig": { + "description": "URL to the multi-MIG that this Managed Instance Group belongs to.", + "type": "string" + }, "name": { "annotations": { "required": [ @@ -65723,6 +65744,11 @@ "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.", "type": "string" }, + "producerPort": { + "description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type", + "format": "int32", + "type": "integer" + }, "pscConnectionId": { "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.", "format": "uint64", @@ -84304,7 +84330,7 @@ "type": "string" }, "internalIpv6Prefix": { - "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", + "description": "The internal IPv6 address range that is owned by this subnetwork.", "type": "string" }, "ipCidrRange": { diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index 58e07df7614..b9ffa516de7 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -4619,6 +4619,8 @@ type BackendBucket struct { Name string `json:"name,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // UsedBy: [Output Only] List of resources referencing that backend bucket. + UsedBy []*BackendBucketUsedBy `json:"usedBy,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -5008,6 +5010,28 @@ func (s BackendBucketListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type BackendBucketUsedBy struct { + // Reference: [Output Only] Server-defined URL for UrlMaps referencing that + // BackendBucket. + Reference string `json:"reference,omitempty"` + // ForceSendFields is a list of field names (e.g. "Reference") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Reference") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendBucketUsedBy) MarshalJSON() ([]byte, error) { + type NoMethod BackendBucketUsedBy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackendService: Represents a Backend Service resource. A backend service // defines how Google Cloud load balancers distribute traffic. The backend // service configuration contains a set of values, such as the protocol used to @@ -17644,6 +17668,8 @@ type InstanceGroupManager struct { // "PAGINATED" - Pagination is enabled for the group's listManagedInstances // API method. maxResults and pageToken query parameters are respected. ListManagedInstancesResults string `json:"listManagedInstancesResults,omitempty"` + // MultiMig: URL to the multi-MIG that this Managed Instance Group belongs to. + MultiMig string `json:"multiMig,omitempty"` // Name: The name of the managed instance group. The name must be 1-63 // characters long, and comply with RFC1035. Name string `json:"name,omitempty"` @@ -28834,6 +28860,10 @@ type NetworkEndpointGroupPscData struct { // for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as // an endpoint in L7 PSC-XLB. ConsumerPscAddress string `json:"consumerPscAddress,omitempty"` + // ProducerPort: The psc producer port is used to connect PSC NEG with specific + // port on the PSC Producer side; should only be used for the + // PRIVATE_SERVICE_CONNECT NEG type + ProducerPort int64 `json:"producerPort,omitempty"` // PscConnectionId: [Output Only] The PSC connection id of the PSC Network // Endpoint Group Consumer. PscConnectionId uint64 `json:"pscConnectionId,omitempty,string"` @@ -48878,8 +48908,8 @@ type Subnetwork struct { // Id: [Output Only] The unique identifier for the resource. This identifier is // defined by the server. Id uint64 `json:"id,omitempty,string"` - // InternalIpv6Prefix: [Output Only] The internal IPv6 address range that is - // assigned to this subnetwork. + // InternalIpv6Prefix: The internal IPv6 address range that is owned by this + // subnetwork. InternalIpv6Prefix string `json:"internalIpv6Prefix,omitempty"` // IpCidrRange: The range of internal addresses that are owned by this // subnetwork. Provide this property when you create the subnetwork. For diff --git a/compute/v0.beta/compute2-gen.go b/compute/v0.beta/compute2-gen.go index db74c4a686b..bb9ee65edef 100644 --- a/compute/v0.beta/compute2-gen.go +++ b/compute/v0.beta/compute2-gen.go @@ -5635,8 +5635,8 @@ type BackendServicesListUsableCall struct { header_ http.Header } -// ListUsable: Retrieves an aggregated list of all usable backend services in -// the specified project. +// ListUsable: Retrieves a list of all usable backend services in the specified +// project. // // - project: Project ID for this request. func (r *BackendServicesService) ListUsable(project string) *BackendServicesListUsableCall { diff --git a/compute/v0.beta/compute3-gen.go b/compute/v0.beta/compute3-gen.go index 9bf8314d681..8ef614c2273 100644 --- a/compute/v0.beta/compute3-gen.go +++ b/compute/v0.beta/compute3-gen.go @@ -1761,8 +1761,8 @@ type RegionBackendServicesListUsableCall struct { header_ http.Header } -// ListUsable: Retrieves an aggregated list of all usable backend services in -// the specified project in the given region. +// ListUsable: Retrieves a list of all usable backend services in the specified +// project in the given region. // // - project: Project ID for this request. // - region: Name of the region scoping this request. It must be a string that diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 70bd1cc810f..fcf10a73c27 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -1915,7 +1915,7 @@ ] }, "listUsable": { - "description": "Retrieves an aggregated list of all usable backend services in the specified project.", + "description": "Retrieves a list of all usable backend services in the specified project.", "flatPath": "projects/{project}/global/backendServices/listUsable", "httpMethod": "GET", "id": "compute.backendServices.listUsable", @@ -20638,7 +20638,7 @@ ] }, "listUsable": { - "description": "Retrieves an aggregated list of all usable backend services in the specified project in the given region.", + "description": "Retrieves a list of all usable backend services in the specified project in the given region.", "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", "httpMethod": "GET", "id": "compute.regionBackendServices.listUsable", @@ -37779,7 +37779,7 @@ } } }, - "revision": "20240827", + "revision": "20240903", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -40488,6 +40488,13 @@ "selfLink": { "description": "[Output Only] Server-defined URL for the resource.", "type": "string" + }, + "usedBy": { + "description": "[Output Only] List of resources referencing that backend bucket.", + "items": { + "$ref": "BackendBucketUsedBy" + }, + "type": "array" } }, "type": "object" @@ -40774,6 +40781,16 @@ }, "type": "object" }, + "BackendBucketUsedBy": { + "id": "BackendBucketUsedBy", + "properties": { + "reference": { + "description": "[Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.", + "type": "string" + } + }, + "type": "object" + }, "BackendService": { "description": "Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) For more information, see Backend Services.", "id": "BackendService", @@ -60665,6 +60682,11 @@ "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.", "type": "string" }, + "producerPort": { + "description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type", + "format": "int32", + "type": "integer" + }, "pscConnectionId": { "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.", "format": "uint64", @@ -78077,7 +78099,7 @@ "type": "string" }, "internalIpv6Prefix": { - "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", + "description": "The internal IPv6 address range that is owned by this subnetwork.", "type": "string" }, "ipCidrRange": { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index ca8f1ffd01f..1a0dde8f2d2 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -4492,6 +4492,8 @@ type BackendBucket struct { Name string `json:"name,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // UsedBy: [Output Only] List of resources referencing that backend bucket. + UsedBy []*BackendBucketUsedBy `json:"usedBy,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -4881,6 +4883,28 @@ func (s BackendBucketListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type BackendBucketUsedBy struct { + // Reference: [Output Only] Server-defined URL for UrlMaps referencing that + // BackendBucket. + Reference string `json:"reference,omitempty"` + // ForceSendFields is a list of field names (e.g. "Reference") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Reference") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendBucketUsedBy) MarshalJSON() ([]byte, error) { + type NoMethod BackendBucketUsedBy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackendService: Represents a Backend Service resource. A backend service // defines how Google Cloud load balancers distribute traffic. The backend // service configuration contains a set of values, such as the protocol used to @@ -27686,6 +27710,10 @@ type NetworkEndpointGroupPscData struct { // for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as // an endpoint in L7 PSC-XLB. ConsumerPscAddress string `json:"consumerPscAddress,omitempty"` + // ProducerPort: The psc producer port is used to connect PSC NEG with specific + // port on the PSC Producer side; should only be used for the + // PRIVATE_SERVICE_CONNECT NEG type + ProducerPort int64 `json:"producerPort,omitempty"` // PscConnectionId: [Output Only] The PSC connection id of the PSC Network // Endpoint Group Consumer. PscConnectionId uint64 `json:"pscConnectionId,omitempty,string"` @@ -46388,8 +46416,8 @@ type Subnetwork struct { // Id: [Output Only] The unique identifier for the resource. This identifier is // defined by the server. Id uint64 `json:"id,omitempty,string"` - // InternalIpv6Prefix: [Output Only] The internal IPv6 address range that is - // assigned to this subnetwork. + // InternalIpv6Prefix: The internal IPv6 address range that is owned by this + // subnetwork. InternalIpv6Prefix string `json:"internalIpv6Prefix,omitempty"` // IpCidrRange: The range of internal addresses that are owned by this // subnetwork. Provide this property when you create the subnetwork. For diff --git a/compute/v1/compute2-gen.go b/compute/v1/compute2-gen.go index 8b9c7f13e74..74f8dee4bf6 100644 --- a/compute/v1/compute2-gen.go +++ b/compute/v1/compute2-gen.go @@ -5413,8 +5413,8 @@ type BackendServicesListUsableCall struct { header_ http.Header } -// ListUsable: Retrieves an aggregated list of all usable backend services in -// the specified project. +// ListUsable: Retrieves a list of all usable backend services in the specified +// project. // // - project: Project ID for this request. func (r *BackendServicesService) ListUsable(project string) *BackendServicesListUsableCall { diff --git a/compute/v1/compute3-gen.go b/compute/v1/compute3-gen.go index 71248bab0cc..dc8c4d4ffcf 100644 --- a/compute/v1/compute3-gen.go +++ b/compute/v1/compute3-gen.go @@ -1650,8 +1650,8 @@ type RegionBackendServicesListUsableCall struct { header_ http.Header } -// ListUsable: Retrieves an aggregated list of all usable backend services in -// the specified project in the given region. +// ListUsable: Retrieves a list of all usable backend services in the specified +// project in the given region. // // - project: Project ID for this request. // - region: Name of the region scoping this request. It must be a string that diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index 5eb074f8b68..a2e8fab6e07 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -1531,7 +1531,7 @@ } } }, - "revision": "20240805", + "revision": "20240910", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { @@ -2173,6 +2173,10 @@ ], "type": "string" }, + "metadataJson": { + "description": "Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.", + "type": "string" + }, "name": { "description": "Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}", "type": "string" @@ -4774,6 +4778,10 @@ ], "type": "string" }, + "metadataJson": { + "description": "Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.", + "type": "string" + }, "name": { "description": "Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}", "type": "string" diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index 17ab18a9fc5..1d3ae819961 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -973,6 +973,10 @@ type GoogleCloudContactcenterinsightsV1Conversation struct { // phone. // "CHAT" - The format for conversations that took place over chat. Medium string `json:"medium,omitempty"` + // MetadataJson: Input only. JSON Metadata encoded as a string. This field is + // primarily used by Insights integrations with various telphony systems and + // must be in one of Insights' supported formats. + MetadataJson string `json:"metadataJson,omitempty"` // Name: Immutable. The resource name of the conversation. Format: // projects/{project}/locations/{location}/conversations/{conversation} Name string `json:"name,omitempty"` @@ -4368,6 +4372,10 @@ type GoogleCloudContactcenterinsightsV1alpha1Conversation struct { // phone. // "CHAT" - The format for conversations that took place over chat. Medium string `json:"medium,omitempty"` + // MetadataJson: Input only. JSON Metadata encoded as a string. This field is + // primarily used by Insights integrations with various telphony systems and + // must be in one of Insights' supported formats. + MetadataJson string `json:"metadataJson,omitempty"` // Name: Immutable. The resource name of the conversation. Format: // projects/{project}/locations/{location}/conversations/{conversation} Name string `json:"name,omitempty"` diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index d81a01da7b4..264fde66388 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1250,7 +1250,7 @@ } } }, - "revision": "20240814", + "revision": "20240904", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AppendOnly": { @@ -2778,6 +2778,10 @@ "cdcStrategy": { "$ref": "CdcStrategy", "description": "Optional. The CDC strategy of the stream. If not set, the system's default value will be used." + }, + "force": { + "description": "Optional. Update the stream without validating it.", + "type": "boolean" } }, "type": "object" diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index d28421c84fc..b10b945d3f3 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -1990,6 +1990,8 @@ type RunStreamRequest struct { // CdcStrategy: Optional. The CDC strategy of the stream. If not set, the // system's default value will be used. CdcStrategy *CdcStrategy `json:"cdcStrategy,omitempty"` + // Force: Optional. Update the stream without validating it. + Force bool `json:"force,omitempty"` // ForceSendFields is a list of field names (e.g. "CdcStrategy") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index 23e0ca6c5d9..989560f833e 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20240906", + "revision": "20240911", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -312,6 +312,11 @@ "readOnly": true, "type": "integer" }, + "logprobsResult": { + "$ref": "GoogleCloudAiplatformV1beta1LogprobsResult", + "description": "Output only. Log-likelihood scores for the response tokens and top tokens", + "readOnly": true + }, "safetyRatings": { "description": "Output only. List of ratings for the safety of a response candidate. There is at most one rating per category.", "items": { @@ -621,6 +626,11 @@ "readOnly": true, "type": "array" }, + "modelVersion": { + "description": "Output only. The model version used to generate the response.", + "readOnly": true, + "type": "string" + }, "promptFeedback": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback", "description": "Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations.", @@ -714,6 +724,11 @@ "format": "float", "type": "number" }, + "logprobs": { + "description": "Optional. Logit probabilities.", + "format": "int32", + "type": "integer" + }, "maxOutputTokens": { "description": "Optional. The maximum number of output tokens to generate per message.", "format": "int32", @@ -724,6 +739,10 @@ "format": "float", "type": "number" }, + "responseLogprobs": { + "description": "Optional. If true, export the logprobs results in response.", + "type": "boolean" + }, "responseMimeType": { "description": "Optional. Output response mimetype of the generated candidate text. Supported mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON response in the candidates. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature.", "type": "string" @@ -932,6 +951,62 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1LogprobsResult": { + "description": "Logprobs Result", + "id": "GoogleCloudAiplatformV1beta1LogprobsResult", + "properties": { + "chosenCandidates": { + "description": "Length = total number of decoding steps. The chosen candidates may or may not be in top_candidates.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate" + }, + "type": "array" + }, + "topCandidates": { + "description": "Length = total number of decoding steps.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1LogprobsResultCandidate": { + "description": "Candidate for the logprobs token and score.", + "id": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate", + "properties": { + "logProbability": { + "description": "The candidate's log probability.", + "format": "float", + "type": "number" + }, + "token": { + "description": "The candidate’s token string value.", + "type": "string" + }, + "tokenId": { + "description": "The candidate’s token id value.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates": { + "description": "Candidates with top log probabilities at each decoding step.", + "id": "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates", + "properties": { + "candidates": { + "description": "Sorted by log probability in descending order.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1Part": { "description": "A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.", "id": "GoogleCloudAiplatformV1beta1Part", @@ -1307,7 +1382,7 @@ "id": "GoogleCloudAiplatformV1beta1Tool", "properties": { "functionDeclarations": { - "description": "Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 64 function declarations can be provided.", + "description": "Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FunctionDeclaration" }, diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 84b402dcb62..b6e2df51da4 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -303,6 +303,9 @@ type GoogleCloudAiplatformV1beta1Candidate struct { GroundingMetadata *GoogleCloudAiplatformV1beta1GroundingMetadata `json:"groundingMetadata,omitempty"` // Index: Output only. Index of the candidate. Index int64 `json:"index,omitempty"` + // LogprobsResult: Output only. Log-likelihood scores for the response tokens + // and top tokens + LogprobsResult *GoogleCloudAiplatformV1beta1LogprobsResult `json:"logprobsResult,omitempty"` // SafetyRatings: Output only. List of ratings for the safety of a response // candidate. There is at most one rating per category. SafetyRatings []*GoogleCloudAiplatformV1beta1SafetyRating `json:"safetyRatings,omitempty"` @@ -726,6 +729,8 @@ func (s GoogleCloudAiplatformV1beta1GenerateContentRequest) MarshalJSON() ([]byt type GoogleCloudAiplatformV1beta1GenerateContentResponse struct { // Candidates: Output only. Generated candidates. Candidates []*GoogleCloudAiplatformV1beta1Candidate `json:"candidates,omitempty"` + // ModelVersion: Output only. The model version used to generate the response. + ModelVersion string `json:"modelVersion,omitempty"` // PromptFeedback: Output only. Content filter results for a prompt sent in the // request. Note: Sent only in the first stream chunk. Only happens when no // candidates were generated due to content violations. @@ -826,11 +831,16 @@ type GoogleCloudAiplatformV1beta1GenerationConfig struct { CandidateCount int64 `json:"candidateCount,omitempty"` // FrequencyPenalty: Optional. Frequency penalties. FrequencyPenalty float64 `json:"frequencyPenalty,omitempty"` + // Logprobs: Optional. Logit probabilities. + Logprobs int64 `json:"logprobs,omitempty"` // MaxOutputTokens: Optional. The maximum number of output tokens to generate // per message. MaxOutputTokens int64 `json:"maxOutputTokens,omitempty"` // PresencePenalty: Optional. Positive penalties. PresencePenalty float64 `json:"presencePenalty,omitempty"` + // ResponseLogprobs: Optional. If true, export the logprobs results in + // response. + ResponseLogprobs bool `json:"responseLogprobs,omitempty"` // ResponseMimeType: Optional. Output response mimetype of the generated // candidate text. Supported mimetype: - `text/plain`: (default) Text output. - // `application/json`: JSON response in the candidates. The model needs to be @@ -1136,6 +1146,95 @@ func (s *GoogleCloudAiplatformV1beta1GroundingSupport) UnmarshalJSON(data []byte return nil } +// GoogleCloudAiplatformV1beta1LogprobsResult: Logprobs Result +type GoogleCloudAiplatformV1beta1LogprobsResult struct { + // ChosenCandidates: Length = total number of decoding steps. The chosen + // candidates may or may not be in top_candidates. + ChosenCandidates []*GoogleCloudAiplatformV1beta1LogprobsResultCandidate `json:"chosenCandidates,omitempty"` + // TopCandidates: Length = total number of decoding steps. + TopCandidates []*GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates `json:"topCandidates,omitempty"` + // ForceSendFields is a list of field names (e.g. "ChosenCandidates") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ChosenCandidates") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1LogprobsResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1LogprobsResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1LogprobsResultCandidate: Candidate for the +// logprobs token and score. +type GoogleCloudAiplatformV1beta1LogprobsResultCandidate struct { + // LogProbability: The candidate's log probability. + LogProbability float64 `json:"logProbability,omitempty"` + // Token: The candidate’s token string value. + Token string `json:"token,omitempty"` + // TokenId: The candidate’s token id value. + TokenId int64 `json:"tokenId,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogProbability") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LogProbability") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1LogprobsResultCandidate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1LogprobsResultCandidate + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudAiplatformV1beta1LogprobsResultCandidate) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1beta1LogprobsResultCandidate + var s1 struct { + LogProbability gensupport.JSONFloat64 `json:"logProbability"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.LogProbability = float64(s1.LogProbability) + return nil +} + +// GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates: Candidates with top +// log probabilities at each decoding step. +type GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates struct { + // Candidates: Sorted by log probability in descending order. + Candidates []*GoogleCloudAiplatformV1beta1LogprobsResultCandidate `json:"candidates,omitempty"` + // ForceSendFields is a list of field names (e.g. "Candidates") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Candidates") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1Part: A datatype containing media that is part // of a multi-part `Content` message. A `Part` consists of data which has an // associated datatype. A `Part` can only contain one of the accepted types in @@ -1503,7 +1602,7 @@ type GoogleCloudAiplatformV1beta1Tool struct { // Model may decide to call a subset of these functions by populating // FunctionCall in the response. User should provide a FunctionResponse for // each function call in the next turn. Based on the function responses, Model - // will generate the final response back to the user. Maximum 64 function + // will generate the final response back to the user. Maximum 128 function // declarations can be provided. FunctionDeclarations []*GoogleCloudAiplatformV1beta1FunctionDeclaration `json:"functionDeclarations,omitempty"` // GoogleSearchRetrieval: Optional. GoogleSearchRetrieval tool type. diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index d7fbeea8acd..2202525aacc 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -793,6 +793,41 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "generateExclusivityManifest": { + "description": "GenerateExclusivityManifest generates the manifests to update the exclusivity artifacts in the cluster if needed. Exclusivity artifacts include the Membership custom resource definition (CRD) and the singleton Membership custom resource (CR). Combined with ValidateExclusivity, exclusivity artifacts guarantee that a Kubernetes cluster is only registered to a single GKE Hub. The Membership CRD is versioned, and may require conversion when the GKE Hub API server begins serving a newer version of the CRD and corresponding CR. The response will be the converted CRD and CR if there are any differences between the versions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}:generateExclusivityManifest", + "httpMethod": "GET", + "id": "gkehub.projects.locations.memberships.generateExclusivityManifest", + "parameterOrder": [ + "name" + ], + "parameters": { + "crManifest": { + "description": "Optional. The YAML manifest of the membership CR retrieved by `kubectl get memberships membership`. Leave empty if the resource does not exist.", + "location": "query", + "type": "string" + }, + "crdManifest": { + "description": "Optional. The YAML manifest of the membership CRD retrieved by `kubectl get customresourcedefinitions membership`. Leave empty if the resource does not exist.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The Membership resource name in the format `projects/*/locations/*/memberships/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/memberships/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:generateExclusivityManifest", + "response": { + "$ref": "GenerateExclusivityManifestResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets the details of a Membership.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}", @@ -1063,6 +1098,41 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "validateExclusivity": { + "description": "ValidateExclusivity validates the state of exclusivity in the cluster. The validation does not depend on an existing Hub membership resource.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/memberships:validateExclusivity", + "httpMethod": "GET", + "id": "gkehub.projects.locations.memberships.validateExclusivity", + "parameterOrder": [ + "parent" + ], + "parameters": { + "crManifest": { + "description": "Optional. The YAML of the membership CR in the cluster. Empty if the membership CR does not exist.", + "location": "query", + "type": "string" + }, + "intendedMembership": { + "description": "Required. The intended membership name under the `parent`. This method only does validation in anticipation of a CreateMembership call with the same name.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent (project and location) where the Memberships will be created. Specified in the format `projects/*/locations/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/memberships:validateExclusivity", + "response": { + "$ref": "ValidateExclusivityResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -2185,7 +2255,7 @@ } } }, - "revision": "20240902", + "revision": "20240909", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -4351,6 +4421,21 @@ }, "type": "object" }, + "GenerateExclusivityManifestResponse": { + "description": "The response of the exclusivity artifacts manifests for the client to apply.", + "id": "GenerateExclusivityManifestResponse", + "properties": { + "crManifest": { + "description": "The YAML manifest of the membership CR to apply if a new version of the CR is available. Empty if no update needs to be applied.", + "type": "string" + }, + "crdManifest": { + "description": "The YAML manifest of the membership CRD to apply if a newer version of the CRD is available. Empty if no update needs to be applied.", + "type": "string" + } + }, + "type": "object" + }, "GenerateMembershipRBACRoleBindingYAMLResponse": { "description": "Response for GenerateRBACRoleBindingYAML.", "id": "GenerateMembershipRBACRoleBindingYAMLResponse", @@ -7065,6 +7150,17 @@ }, "type": "object" }, + "ValidateExclusivityResponse": { + "description": "The response of exclusivity artifacts validation result status.", + "id": "ValidateExclusivityResponse", + "properties": { + "status": { + "$ref": "GoogleRpcStatus", + "description": "The validation result. * `OK` means that exclusivity is validated, assuming the manifest produced by GenerateExclusivityManifest is successfully applied. * `ALREADY_EXISTS` means that the Membership CRD is already owned by another Hub. See `status.message` for more information." + } + }, + "type": "object" + }, "ValidationResult": { "description": "ValidationResults are results set by each validator running during ValidateCreateMembership.", "id": "ValidationResult", diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index d252d2337a6..8d8cb2f6cf4 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -3022,6 +3022,36 @@ func (s GenerateConnectManifestResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GenerateExclusivityManifestResponse: The response of the exclusivity +// artifacts manifests for the client to apply. +type GenerateExclusivityManifestResponse struct { + // CrManifest: The YAML manifest of the membership CR to apply if a new version + // of the CR is available. Empty if no update needs to be applied. + CrManifest string `json:"crManifest,omitempty"` + // CrdManifest: The YAML manifest of the membership CRD to apply if a newer + // version of the CRD is available. Empty if no update needs to be applied. + CrdManifest string `json:"crdManifest,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CrManifest") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CrManifest") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GenerateExclusivityManifestResponse) MarshalJSON() ([]byte, error) { + type NoMethod GenerateExclusivityManifestResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GenerateMembershipRBACRoleBindingYAMLResponse: Response for // GenerateRBACRoleBindingYAML. type GenerateMembershipRBACRoleBindingYAMLResponse struct { @@ -6450,6 +6480,35 @@ func (s ValidateCreateMembershipResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ValidateExclusivityResponse: The response of exclusivity artifacts +// validation result status. +type ValidateExclusivityResponse struct { + // Status: The validation result. * `OK` means that exclusivity is validated, + // assuming the manifest produced by GenerateExclusivityManifest is + // successfully applied. * `ALREADY_EXISTS` means that the Membership CRD is + // already owned by another Hub. See `status.message` for more information. + Status *GoogleRpcStatus `json:"status,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Status") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Status") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ValidateExclusivityResponse) MarshalJSON() ([]byte, error) { + type NoMethod ValidateExclusivityResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ValidationResult: ValidationResults are results set by each validator // running during ValidateCreateMembership. type ValidationResult struct { @@ -8876,6 +8935,140 @@ func (c *ProjectsLocationsMembershipsGenerateConnectManifestCall) Do(opts ...goo return ret, nil } +type ProjectsLocationsMembershipsGenerateExclusivityManifestCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GenerateExclusivityManifest: GenerateExclusivityManifest generates the +// manifests to update the exclusivity artifacts in the cluster if needed. +// Exclusivity artifacts include the Membership custom resource definition +// (CRD) and the singleton Membership custom resource (CR). Combined with +// ValidateExclusivity, exclusivity artifacts guarantee that a Kubernetes +// cluster is only registered to a single GKE Hub. The Membership CRD is +// versioned, and may require conversion when the GKE Hub API server begins +// serving a newer version of the CRD and corresponding CR. The response will +// be the converted CRD and CR if there are any differences between the +// versions. +// +// - name: The Membership resource name in the format +// `projects/*/locations/*/memberships/*`. +func (r *ProjectsLocationsMembershipsService) GenerateExclusivityManifest(name string) *ProjectsLocationsMembershipsGenerateExclusivityManifestCall { + c := &ProjectsLocationsMembershipsGenerateExclusivityManifestCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// CrManifest sets the optional parameter "crManifest": The YAML manifest of +// the membership CR retrieved by `kubectl get memberships membership`. Leave +// empty if the resource does not exist. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) CrManifest(crManifest string) *ProjectsLocationsMembershipsGenerateExclusivityManifestCall { + c.urlParams_.Set("crManifest", crManifest) + return c +} + +// CrdManifest sets the optional parameter "crdManifest": The YAML manifest of +// the membership CRD retrieved by `kubectl get customresourcedefinitions +// membership`. Leave empty if the resource does not exist. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) CrdManifest(crdManifest string) *ProjectsLocationsMembershipsGenerateExclusivityManifestCall { + c.urlParams_.Set("crdManifest", crdManifest) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) Fields(s ...googleapi.Field) *ProjectsLocationsMembershipsGenerateExclusivityManifestCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) IfNoneMatch(entityTag string) *ProjectsLocationsMembershipsGenerateExclusivityManifestCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) Context(ctx context.Context) *ProjectsLocationsMembershipsGenerateExclusivityManifestCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:generateExclusivityManifest") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkehub.projects.locations.memberships.generateExclusivityManifest" call. +// Any non-2xx status code is an error. Response headers are in either +// *GenerateExclusivityManifestResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsMembershipsGenerateExclusivityManifestCall) Do(opts ...googleapi.CallOption) (*GenerateExclusivityManifestResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GenerateExclusivityManifestResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsMembershipsGetCall struct { s *Service name string @@ -9884,6 +10077,133 @@ func (c *ProjectsLocationsMembershipsValidateCreateCall) Do(opts ...googleapi.Ca return ret, nil } +type ProjectsLocationsMembershipsValidateExclusivityCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ValidateExclusivity: ValidateExclusivity validates the state of exclusivity +// in the cluster. The validation does not depend on an existing Hub membership +// resource. +// +// - parent: The parent (project and location) where the Memberships will be +// created. Specified in the format `projects/*/locations/*`. +func (r *ProjectsLocationsMembershipsService) ValidateExclusivity(parent string) *ProjectsLocationsMembershipsValidateExclusivityCall { + c := &ProjectsLocationsMembershipsValidateExclusivityCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// CrManifest sets the optional parameter "crManifest": The YAML of the +// membership CR in the cluster. Empty if the membership CR does not exist. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) CrManifest(crManifest string) *ProjectsLocationsMembershipsValidateExclusivityCall { + c.urlParams_.Set("crManifest", crManifest) + return c +} + +// IntendedMembership sets the optional parameter "intendedMembership": +// Required. The intended membership name under the `parent`. This method only +// does validation in anticipation of a CreateMembership call with the same +// name. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) IntendedMembership(intendedMembership string) *ProjectsLocationsMembershipsValidateExclusivityCall { + c.urlParams_.Set("intendedMembership", intendedMembership) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) Fields(s ...googleapi.Field) *ProjectsLocationsMembershipsValidateExclusivityCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) IfNoneMatch(entityTag string) *ProjectsLocationsMembershipsValidateExclusivityCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) Context(ctx context.Context) *ProjectsLocationsMembershipsValidateExclusivityCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/memberships:validateExclusivity") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkehub.projects.locations.memberships.validateExclusivity" call. +// Any non-2xx status code is an error. Response headers are in either +// *ValidateExclusivityResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsMembershipsValidateExclusivityCall) Do(opts ...googleapi.CallOption) (*ValidateExclusivityResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ValidateExclusivityResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsMembershipsBindingsCreateCall struct { s *Service parent string diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json index 63d2c8d0aad..653ca4d6207 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-api.json +++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json @@ -147,7 +147,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which the assessment will be created, in the format `projects/{project}`.", + "description": "Required. The name of the project in which the assessment is created, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -179,7 +179,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project this policy will apply to, in the format `projects/{project}`.", + "description": "Required. The name of the project this policy applies to, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -300,7 +300,7 @@ "type": "string" }, "updateMask": { - "description": "Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields will be updated.", + "description": "Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields are updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -350,7 +350,7 @@ "keys": { "methods": { "addIpOverride": { - "description": "Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error will be returned.", + "description": "Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error is returned.", "flatPath": "v1/projects/{projectsId}/keys/{keysId}:addIpOverride", "httpMethod": "POST", "id": "recaptchaenterprise.projects.keys.addIpOverride", @@ -387,7 +387,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which the key will be created, in the format `projects/{project}`.", + "description": "Required. The name of the project in which the key is created, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -501,7 +501,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the project that contains the keys that will be listed, in the format `projects/{project}`.", + "description": "Required. The name of the project that contains the keys that is listed, in the format `projects/{project}`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -597,7 +597,7 @@ "type": "string" }, "updateMask": { - "description": "Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields will be updated.", + "description": "Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields are updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -615,7 +615,7 @@ ] }, "removeIpOverride": { - "description": "Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error will be returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error will be returned.", + "description": "Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error is returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error is returned.", "flatPath": "v1/projects/{projectsId}/keys/{keysId}:removeIpOverride", "httpMethod": "POST", "id": "recaptchaenterprise.projects.keys.removeIpOverride", @@ -786,7 +786,7 @@ } } }, - "revision": "20240825", + "revision": "20240906", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -918,7 +918,7 @@ "type": "string" }, "annotation": { - "description": "Optional. The annotation that will be assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent.", + "description": "Optional. The annotation that is assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent.", "enum": [ "ANNOTATION_UNSPECIFIED", "LEGITIMATE", @@ -1164,7 +1164,7 @@ "type": "boolean" }, "firewallPolicyEvaluation": { - "description": "Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy will be evaluated and a suggested firewall action will be returned in the response.", + "description": "Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy is evaluated and a suggested firewall action is returned in the response.", "type": "boolean" }, "fraudPrevention": { @@ -1249,23 +1249,23 @@ }, "block": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionBlockAction", - "description": "This action will deny access to a given page. The user will get an HTTP error code." + "description": "This action denies access to a given page. The user gets an HTTP error code." }, "includeRecaptchaScript": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionIncludeRecaptchaScriptAction", - "description": "This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend." + "description": "This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend." }, "redirect": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction", - "description": "This action will redirect the request to a ReCaptcha interstitial to attach a token." + "description": "This action redirects the request to a reCAPTCHA interstitial to attach a token." }, "setHeader": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction", - "description": "This action will set a custom header but allow the request to continue to the customer backend." + "description": "This action sets a custom header but allow the request to continue to the customer backend." }, "substitute": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction", - "description": "This action will transparently serve a different page to an offending user." + "description": "This action transparently serves a different page to an offending user." } }, "type": "object" @@ -1289,7 +1289,7 @@ "type": "object" }, "GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction": { - "description": "A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token.", + "description": "A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token.", "id": "GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction", "properties": {}, "type": "object" @@ -1356,12 +1356,12 @@ "properties": { "error": { "$ref": "GoogleRpcStatus", - "description": "Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty.", + "description": "Output only. If the processing of a policy config fails, an error is populated and the firewall_policy is left empty.", "readOnly": true }, "firewallPolicy": { "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallPolicy", - "description": "Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field will be left empty.", + "description": "Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field is left empty.", "readOnly": true } }, @@ -1514,7 +1514,7 @@ }, "appleDeveloperId": { "$ref": "GoogleCloudRecaptchaenterpriseV1AppleDeveloperId", - "description": "Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app." + "description": "Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app." } }, "type": "object" @@ -1689,7 +1689,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1Metrics", "properties": { "challengeMetrics": { - "description": "Metrics will be continuous and in order by dates, and in the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE), will have challenge-based data.", + "description": "Metrics are continuous and in order by dates, and in the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE) have challenge-based data.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1ChallengeMetrics" }, @@ -1701,7 +1701,7 @@ "type": "string" }, "scoreMetrics": { - "description": "Metrics will be continuous and in order by dates, and in the granularity of day. All Key types should have score-based data.", + "description": "Metrics are continuous and in order by dates, and in the granularity of day. All Key types should have score-based data.", "items": { "$ref": "GoogleCloudRecaptchaenterpriseV1ScoreMetrics" }, @@ -2010,7 +2010,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1TestingOptions", "properties": { "testingChallenge": { - "description": "Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.", + "description": "Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.", "enum": [ "TESTING_CHALLENGE_UNSPECIFIED", "NOCAPTCHA", @@ -2024,7 +2024,7 @@ "type": "string" }, "testingScore": { - "description": "Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.", + "description": "Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.", "format": "float", "type": "number" } @@ -2410,13 +2410,15 @@ "WAF_SERVICE_UNSPECIFIED", "CA", "FASTLY", - "CLOUDFLARE" + "CLOUDFLARE", + "AKAMAI" ], "enumDescriptions": [ "Undefined WAF", "Cloud Armor", "Fastly", - "Cloudflare" + "Cloudflare", + "Akamai" ], "type": "string" } @@ -2428,7 +2430,7 @@ "id": "GoogleCloudRecaptchaenterpriseV1WebKeySettings", "properties": { "allowAllDomains": { - "description": "Optional. If set to true, it means allowed_domains will not be enforced.", + "description": "Optional. If set to true, it means allowed_domains are not enforced.", "type": "boolean" }, "allowAmpTraffic": { @@ -2443,7 +2445,7 @@ "type": "array" }, "challengeSecurityPreference": { - "description": "Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.", + "description": "Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.", "enum": [ "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED", "USABILITY", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go index 08752d9fd44..9a4564d0865 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go +++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go @@ -395,9 +395,9 @@ type GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest struct { // example when a stable account identifier is not yet known in the initial // request. AccountId string `json:"accountId,omitempty"` - // Annotation: Optional. The annotation that will be assigned to the Event. - // This field can be left empty to provide reasons that apply to an event - // without concluding whether the event is legitimate or fraudulent. + // Annotation: Optional. The annotation that is assigned to the Event. This + // field can be left empty to provide reasons that apply to an event without + // concluding whether the event is legitimate or fraudulent. // // Possible values: // "ANNOTATION_UNSPECIFIED" - Default unspecified type. @@ -686,8 +686,8 @@ type GoogleCloudRecaptchaenterpriseV1Event struct { // without a token. If enabled, `site_key` must reference an Express site key. Express bool `json:"express,omitempty"` // FirewallPolicyEvaluation: Optional. Flag for enabling firewall policy config - // assessment. If this flag is enabled, the firewall policy will be evaluated - // and a suggested firewall action will be returned in the response. + // assessment. If this flag is enabled, the firewall policy is evaluated and a + // suggested firewall action is returned in the response. FirewallPolicyEvaluation bool `json:"firewallPolicyEvaluation,omitempty"` // FraudPrevention: Optional. The Fraud Prevention setting for this assessment. // @@ -767,19 +767,19 @@ type GoogleCloudRecaptchaenterpriseV1FirewallAction struct { // Allow: The user request did not match any policy and should be allowed // access to the requested resource. Allow *GoogleCloudRecaptchaenterpriseV1FirewallActionAllowAction `json:"allow,omitempty"` - // Block: This action will deny access to a given page. The user will get an - // HTTP error code. + // Block: This action denies access to a given page. The user gets an HTTP + // error code. Block *GoogleCloudRecaptchaenterpriseV1FirewallActionBlockAction `json:"block,omitempty"` - // IncludeRecaptchaScript: This action will inject reCAPTCHA JavaScript code - // into the HTML page returned by the site backend. + // IncludeRecaptchaScript: This action injects reCAPTCHA JavaScript code into + // the HTML page returned by the site backend. IncludeRecaptchaScript *GoogleCloudRecaptchaenterpriseV1FirewallActionIncludeRecaptchaScriptAction `json:"includeRecaptchaScript,omitempty"` - // Redirect: This action will redirect the request to a ReCaptcha interstitial - // to attach a token. + // Redirect: This action redirects the request to a reCAPTCHA interstitial to + // attach a token. Redirect *GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction `json:"redirect,omitempty"` - // SetHeader: This action will set a custom header but allow the request to + // SetHeader: This action sets a custom header but allow the request to // continue to the customer backend. SetHeader *GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction `json:"setHeader,omitempty"` - // Substitute: This action will transparently serve a different page to an + // Substitute: This action transparently serves a different page to an // offending user. Substitute *GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction `json:"substitute,omitempty"` // ForceSendFields is a list of field names (e.g. "Allow") to unconditionally @@ -821,7 +821,7 @@ type GoogleCloudRecaptchaenterpriseV1FirewallActionIncludeRecaptchaScriptAction // GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction: A redirect // action returns a 307 (temporary redirect) response, pointing the user to a -// ReCaptcha interstitial page to attach a token. +// reCAPTCHA interstitial page to attach a token. type GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction struct { } @@ -931,12 +931,12 @@ func (s GoogleCloudRecaptchaenterpriseV1FirewallPolicy) MarshalJSON() ([]byte, e // GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment: Policy config // assessment. type GoogleCloudRecaptchaenterpriseV1FirewallPolicyAssessment struct { - // Error: Output only. If the processing of a policy config fails, an error - // will be populated and the firewall_policy will be left empty. + // Error: Output only. If the processing of a policy config fails, an error is + // populated and the firewall_policy is left empty. Error *GoogleRpcStatus `json:"error,omitempty"` // FirewallPolicy: Output only. The policy that matched the request. If more // than one policy may match, this is the first match. If no policy matches the - // incoming request, the policy field will be left empty. + // incoming request, the policy field is left empty. FirewallPolicy *GoogleCloudRecaptchaenterpriseV1FirewallPolicy `json:"firewallPolicy,omitempty"` // ForceSendFields is a list of field names (e.g. "Error") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1233,10 +1233,10 @@ type GoogleCloudRecaptchaenterpriseV1IOSKeySettings struct { // Example: 'com.companyname.productname.appname' AllowedBundleIds []string `json:"allowedBundleIds,omitempty"` // AppleDeveloperId: Optional. Apple Developer account details for the app that - // is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages - // platform-specific checks like Apple App Attest and Apple DeviceCheck to - // protect your app from abuse. Providing these fields allows reCAPTCHA - // Enterprise to get a better assessment of the integrity of your app. + // is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific + // checks like Apple App Attest and Apple DeviceCheck to protect your app from + // abuse. Providing these fields allows reCAPTCHA to get a better assessment of + // the integrity of your app. AppleDeveloperId *GoogleCloudRecaptchaenterpriseV1AppleDeveloperId `json:"appleDeveloperId,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowAllBundleIds") to // unconditionally include in API requests. By default, fields with empty or @@ -1486,14 +1486,14 @@ func (s GoogleCloudRecaptchaenterpriseV1ListRelatedAccountGroupsResponse) Marsha // GoogleCloudRecaptchaenterpriseV1Metrics: Metrics for a single Key. type GoogleCloudRecaptchaenterpriseV1Metrics struct { - // ChallengeMetrics: Metrics will be continuous and in order by dates, and in - // the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE), - // will have challenge-based data. + // ChallengeMetrics: Metrics are continuous and in order by dates, and in the + // granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE) have + // challenge-based data. ChallengeMetrics []*GoogleCloudRecaptchaenterpriseV1ChallengeMetrics `json:"challengeMetrics,omitempty"` // Name: Output only. Identifier. The name of the metrics, in the format // `projects/{project}/keys/{key}/metrics`. Name string `json:"name,omitempty"` - // ScoreMetrics: Metrics will be continuous and in order by dates, and in the + // ScoreMetrics: Metrics are continuous and in order by dates, and in the // granularity of day. All Key types should have score-based data. ScoreMetrics []*GoogleCloudRecaptchaenterpriseV1ScoreMetrics `json:"scoreMetrics,omitempty"` // StartTime: Inclusive start time aligned to a day (UTC). @@ -1992,7 +1992,7 @@ func (s *GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict) UnmarshalJSON(data // testing. type GoogleCloudRecaptchaenterpriseV1TestingOptions struct { // TestingChallenge: Optional. For challenge-based keys only (CHECKBOX, - // INVISIBLE), all challenge requests for this site will return nocaptcha if + // INVISIBLE), all challenge requests for this site return nocaptcha if // NOCAPTCHA, or an unsolvable challenge if CHALLENGE. // // Possible values: @@ -2003,9 +2003,8 @@ type GoogleCloudRecaptchaenterpriseV1TestingOptions struct { // "UNSOLVABLE_CHALLENGE" - Challenge requests for this key always return an // unsolvable challenge. TestingChallenge string `json:"testingChallenge,omitempty"` - // TestingScore: Optional. All assessments for this Key will return this score. - // Must be between 0 (likely not legitimate) and 1 (likely legitimate) - // inclusive. + // TestingScore: Optional. All assessments for this Key return this score. Must + // be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive. TestingScore float64 `json:"testingScore,omitempty"` // ForceSendFields is a list of field names (e.g. "TestingChallenge") to // unconditionally include in API requests. By default, fields with empty or @@ -2516,6 +2515,7 @@ type GoogleCloudRecaptchaenterpriseV1WafSettings struct { // "CA" - Cloud Armor // "FASTLY" - Fastly // "CLOUDFLARE" - Cloudflare + // "AKAMAI" - Akamai WafService string `json:"wafService,omitempty"` // ForceSendFields is a list of field names (e.g. "WafFeature") to // unconditionally include in API requests. By default, fields with empty or @@ -2538,8 +2538,8 @@ func (s GoogleCloudRecaptchaenterpriseV1WafSettings) MarshalJSON() ([]byte, erro // GoogleCloudRecaptchaenterpriseV1WebKeySettings: Settings specific to keys // that can be used by websites. type GoogleCloudRecaptchaenterpriseV1WebKeySettings struct { - // AllowAllDomains: Optional. If set to true, it means allowed_domains will not - // be enforced. + // AllowAllDomains: Optional. If set to true, it means allowed_domains are not + // enforced. AllowAllDomains bool `json:"allowAllDomains,omitempty"` // AllowAmpTraffic: Optional. If set to true, the key can be used on AMP // (Accelerated Mobile Pages) websites. This is supported only for the SCORE @@ -2552,7 +2552,8 @@ type GoogleCloudRecaptchaenterpriseV1WebKeySettings struct { AllowedDomains []string `json:"allowedDomains,omitempty"` // ChallengeSecurityPreference: Optional. Settings for the frequency and // difficulty at which this key triggers captcha challenges. This should only - // be specified for IntegrationTypes CHECKBOX and INVISIBLE. + // be specified for IntegrationTypes CHECKBOX and INVISIBLE and + // SCORE_AND_CHALLENGE. // // Possible values: // "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED" - Default type that indicates @@ -2753,8 +2754,8 @@ type ProjectsAssessmentsCreateCall struct { // Create: Creates an Assessment of the likelihood an event is legitimate. // -// - parent: The name of the project in which the assessment will be created, -// in the format `projects/{project}`. +// - parent: The name of the project in which the assessment is created, in the +// format `projects/{project}`. func (r *ProjectsAssessmentsService) Create(parent string, googlecloudrecaptchaenterprisev1assessment *GoogleCloudRecaptchaenterpriseV1Assessment) *ProjectsAssessmentsCreateCall { c := &ProjectsAssessmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -2858,7 +2859,7 @@ type ProjectsFirewallpoliciesCreateCall struct { // reCAPTCHA Enterprise actions can be executed. A project may have a maximum // of 1000 policies. // -// - parent: The name of the project this policy will apply to, in the format +// - parent: The name of the project this policy applies to, in the format // `projects/{project}`. func (r *ProjectsFirewallpoliciesService) Create(parent string, googlecloudrecaptchaenterprisev1firewallpolicy *GoogleCloudRecaptchaenterpriseV1FirewallPolicy) *ProjectsFirewallpoliciesCreateCall { c := &ProjectsFirewallpoliciesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -3322,7 +3323,7 @@ func (r *ProjectsFirewallpoliciesService) Patch(name string, googlecloudrecaptch // UpdateMask sets the optional parameter "updateMask": The mask to control // which fields of the policy get updated. If the mask is not present, all -// fields will be updated. +// fields are updated. func (c *ProjectsFirewallpoliciesPatchCall) UpdateMask(updateMask string) *ProjectsFirewallpoliciesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -3526,7 +3527,7 @@ type ProjectsKeysAddIpOverrideCall struct { // AddIpOverride: Adds an IP override to a key. The following restrictions // hold: * The maximum number of IP overrides per key is 100. * For any // conflict (such as IP already exists or IP part of an existing IP range), an -// error will be returned. +// error is returned. // // - name: The name of the key to which the IP override is added, in the format // `projects/{project}/keys/{key}`. @@ -3631,8 +3632,8 @@ type ProjectsKeysCreateCall struct { // Create: Creates a new reCAPTCHA Enterprise key. // -// - parent: The name of the project in which the key will be created, in the -// format `projects/{project}`. +// - parent: The name of the project in which the key is created, in the format +// `projects/{project}`. func (r *ProjectsKeysService) Create(parent string, googlecloudrecaptchaenterprisev1key *GoogleCloudRecaptchaenterpriseV1Key) *ProjectsKeysCreateCall { c := &ProjectsKeysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4050,8 +4051,8 @@ type ProjectsKeysListCall struct { // List: Returns the list of all keys that belong to a project. // -// - parent: The name of the project that contains the keys that will be -// listed, in the format `projects/{project}`. +// - parent: The name of the project that contains the keys that is listed, in +// the format `projects/{project}`. func (r *ProjectsKeysService) List(parent string) *ProjectsKeysListCall { c := &ProjectsKeysListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4458,7 +4459,7 @@ func (r *ProjectsKeysService) Patch(name string, googlecloudrecaptchaenterprisev // UpdateMask sets the optional parameter "updateMask": The mask to control // which fields of the key get updated. If the mask is not present, all fields -// will be updated. +// are updated. func (c *ProjectsKeysPatchCall) UpdateMask(updateMask string) *ProjectsKeysPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4558,8 +4559,8 @@ type ProjectsKeysRemoveIpOverrideCall struct { // RemoveIpOverride: Removes an IP override from a key. The following // restrictions hold: * If the IP isn't found in an existing IP override, a -// `NOT_FOUND` error will be returned. * If the IP is found in an existing IP -// override, but the override type does not match, a `NOT_FOUND` error will be +// `NOT_FOUND` error is returned. * If the IP is found in an existing IP +// override, but the override type does not match, a `NOT_FOUND` error is // returned. // // - name: The name of the key from which the IP override is removed, in the diff --git a/sts/v1/sts-api.json b/sts/v1/sts-api.json index 6f9b3ddd75c..c193f24cae9 100644 --- a/sts/v1/sts-api.json +++ b/sts/v1/sts-api.json @@ -116,7 +116,7 @@ } } }, - "revision": "20240704", + "revision": "20240904", "rootUrl": "https://sts.googleapis.com/", "schemas": { "GoogleIamV1Binding": { @@ -194,7 +194,7 @@ "type": "string" }, "requestedTokenType": { - "description": "Required. An identifier for the type of requested security token. Can be `urn:ietf:params:oauth:token-type:access_token` or `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`.", + "description": "Required. An identifier for the type of requested security token. Can be `urn:ietf:params:oauth:token-type:access_token` or `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`.", "type": "string" }, "scope": { @@ -217,7 +217,7 @@ "id": "GoogleIdentityStsV1ExchangeTokenResponse", "properties": { "access_boundary_session_key": { - "description": "The access boundary session key. This key is used along with the access boundary intermediate token to generate Credential Access Boundary tokens at client side. This field is absent when the `requested_token_type` from the request is not `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`.", + "description": "The access boundary session key. This key is used along with the access boundary intermediary token to generate Credential Access Boundary tokens at client side. This field is absent when the `requested_token_type` from the request is not `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`.", "format": "byte", "type": "string" }, diff --git a/sts/v1/sts-gen.go b/sts/v1/sts-gen.go index a6412241748..57c33fd47aa 100644 --- a/sts/v1/sts-gen.go +++ b/sts/v1/sts-gen.go @@ -344,7 +344,7 @@ type GoogleIdentityStsV1ExchangeTokenRequest struct { Options string `json:"options,omitempty"` // RequestedTokenType: Required. An identifier for the type of requested // security token. Can be `urn:ietf:params:oauth:token-type:access_token` or - // `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`. + // `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`. RequestedTokenType string `json:"requestedTokenType,omitempty"` // Scope: The OAuth 2.0 scopes to include on the resulting access token, // formatted as a list of space-delimited, case-sensitive strings. Required @@ -467,10 +467,10 @@ func (s GoogleIdentityStsV1ExchangeTokenRequest) MarshalJSON() ([]byte, error) { // ExchangeToken. type GoogleIdentityStsV1ExchangeTokenResponse struct { // AccessBoundarySessionKey: The access boundary session key. This key is used - // along with the access boundary intermediate token to generate Credential + // along with the access boundary intermediary token to generate Credential // Access Boundary tokens at client side. This field is absent when the // `requested_token_type` from the request is not - // `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`. + // `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`. AccessBoundarySessionKey string `json:"access_boundary_session_key,omitempty"` // AccessToken: An OAuth 2.0 security token, issued by Google, in response to // the token exchange request. Tokens can vary in size, depending in part on diff --git a/translate/v3/translate-api.json b/translate/v3/translate-api.json index ff84ab86a41..fb5f4172702 100644 --- a/translate/v3/translate-api.json +++ b/translate/v3/translate-api.json @@ -1132,7 +1132,8 @@ "$ref": "Operation" }, "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-translation" ] }, "delete": { @@ -1707,7 +1708,7 @@ } } }, - "revision": "20240821", + "revision": "20240912", "rootUrl": "https://translation.googleapis.com/", "schemas": { "AdaptiveMtDataset": {